Zeitplan erstellen

Eine neue geplante Sitzung anlegen.

POST /v3/organizations/{org_id}/schedules

Zeitplan erstellen

cURL

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "agent": "devin",
  "bypass_approval": false,
  "create_as_user_id": "<string>",
  "frequency": "<string>",
  "interval_count": 1,
  "notify_on": "failure",
  "platform": "<string>",
  "playbook_id": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}
'

200

{
  "consecutive_failures": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "enabled": true,
  "frequency": "<string>",
  "last_error_at": "2023-11-07T05:31:56Z",
  "last_error_message": "<string>",
  "last_executed_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "org_id": "<string>",
  "playbook": {
    "playbook_id": "<string>",
    "title": "<string>"
  },
  "prompt": "<string>",
  "scheduled_session_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "bypass_approval": false,
  "interval_count": 1,
  "last_edited_by": "<string>",
  "platform": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}

​

Berechtigungen

Erfordert einen Servicebenutzer mit der Berechtigung ManageOrgSchedules auf Organisationsebene.

​

Zeitplantyp

Das Feld schedule_type gibt an, ob der Zeitplan wiederkehrend oder einmalig ist:

• recurring (Standard) — Erfordert das Feld frequency mit einem Cron-Ausdruck
• one_time — Erfordert das Feld scheduled_at mit einem zukünftigen Datum/Uhrzeitwert im ISO-8601-Format

​

Frequency

Für wiederkehrende Zeitpläne akzeptiert das Feld frequency einen Standard-Cron-Ausdruck (z. B. 0 9 * * 1-5 für Werktage um 9:00 Uhr UTC).

​

Ausführungszeitpunkt

Für einmalige Zeitpläne akzeptiert das Feld scheduled_at einen ISO-8601-Datum-Uhrzeit-Wert mit Zeitzone (z. B. 2026-03-01T09:00:00Z). Dieser Zeitpunkt muss in der Zukunft liegen. Nach der Ausführung wird der Zeitplan automatisch deaktiviert.

​

Agententypen

Agent	Beschreibung
devin	Standard-Devin-Agent (Standardagent)
data_analyst	Datenanalyse-Agent
advanced	Fortgeschrittener Agent

​

Benutzer-Impersonation

Der Parameter create_as_user_id ermöglicht es, einen Zeitplan im Namen eines anderen Benutzers zu erstellen. Dafür müssen folgende Voraussetzungen erfüllt sein:

1. Der Servicebenutzer muss die Berechtigung ImpersonateOrgSessions haben
2. Der Zielbenutzer muss Mitglied der Organisation sein
3. Der Zielbenutzer muss die Berechtigung UseDevinSessions haben

Autorisierungen

Authorization · string · header · erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Body

application/json

name · string · erforderlich

prompt · string · erforderlich

agent · enum<string> · Standard: devin

Verfügbare Optionen: devin, data_analyst

bypass_approval · boolean · Standard: false

create_as_user_id · string | null

frequency · string | null

interval_count · integer · Standard: 1

notify_on · enum<string> · Standard: failure

Verfügbare Optionen: always, failure, never

platform · string | null

VM-Plattform für Sitzungen, die durch diesen Zeitplan gestartet werden (z. B. 'windows'). Wenn kein Wert angegeben ist, verwenden Sitzungen zum Auslösezeitpunkt die Standardplattform der Organisation. Der Wert muss mit einer für die Organisation konfigurierten Plattform übereinstimmen (Groß-/Kleinschreibung wird nicht beachtet); unbekannte Werte werden mit einem 400-Fehler abgelehnt, der die verfügbaren Plattformbezeichnungen auflistet.

playbook_id · string | null

schedule_type · enum<string> · Standard: recurring

Verfügbare Optionen: recurring, one_time

scheduled_at · string<date-time> | null

slack_channel_id · string | null

slack_team_id · string | null

tags · string[] | null

target_devin_id · string | null

Antwort

200

application/json

Antwort bei Erfolg

agent · enum<string> · erforderlich

Verfügbare Optionen: devin, data_analyst

consecutive_failures · integer · erforderlich

created_at · string<date-time> · erforderlich

created_by · string | null · erforderlich

enabled · boolean · erforderlich

frequency · string | null · erforderlich

last_error_at · string<date-time> | null · erforderlich

last_error_message · string | null · erforderlich

last_executed_at · string<date-time> | null · erforderlich

name · string · erforderlich

notify_on · enum<string> · erforderlich

Verfügbare Optionen: always, failure, never

org_id · string · erforderlich

playbook · PlaybookInfo · object · erforderlich

Show child attributes

prompt · string · erforderlich

scheduled_session_id · string · erforderlich

updated_at · string<date-time> · erforderlich

bypass_approval · boolean · Standard: false

interval_count · integer · Standard: 1

last_edited_by · string | null

platform · string | null

schedule_type · enum<string> · Standard: recurring

Verfügbare Optionen: recurring, one_time

scheduled_at · string<date-time> | null

slack_channel_id · string | null

slack_team_id · string | null

tags · string[] | null

target_devin_id · string | null