Zum Hauptinhalt springen
POST
Zeitplan erstellen
Veraltet. Zeitpläne werden durch Automatisierungen abgelöst. Legen Sie geplante Aufgaben stattdessen über POST /v3/organizations/{org_id}/automations als Automatisierung mit einem schedule:recurring-Trigger an. Ab dem 24. September 2026 gibt dieser Endpunkt für Organisationen, die zu Automatisierungen migriert wurden, 403 zurück; Organisationen, deren Migration noch läuft, können bis zum Abschluss der Migration weiterhin Zeitpläne erstellen.

Berechtigungen

Erfordert einen Servicebenutzer oder ein persönliches Zugriffstoken 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

Andere agent-Werte werden mit einem 422-Validierungsfehler abgelehnt.

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

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json
name
string
erforderlich
prompt
string
erforderlich
playbook_id
string | null
skill_ref
SkillReference · object | null

Der konkret verwendete Skill für die Sitzungen. Für neue Konfigurationen anstelle von playbook_id verwenden.

frequency
string | null
interval_count
integer
Standard:1
schedule_type
enum<string>
Standard:recurring
Verfügbare Optionen:
recurring,
one_time
scheduled_at
string<date-time> | null
notify_on
enum<string>
Standard:failure
Verfügbare Optionen:
always,
failure,
never
agent
enum<string>
Standard:devin
Verfügbare Optionen:
devin,
data_analyst
bypass_approval
boolean
Standard:false
create_as_user_id
string | null
slack_channel_id
string | null
slack_team_id
string | null
tags
string[] | null
target_devin_id
string | null
platform
string | null

VM-Plattform für Sitzungen, die durch diesen Zeitplan gestartet werden (z. B. „windows“). Wenn sie weggelassen wird, verwenden Sitzungen beim Auslösen die Standardplattform der Org. 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.

Antwort

Erfolgreiche Antwort

scheduled_session_id
string
erforderlich
org_id
string
erforderlich
created_by
string | null
erforderlich
name
string
erforderlich
prompt
string
erforderlich
playbook
PlaybookInfo · object | null
erforderlich
frequency
string | null
erforderlich
enabled
boolean
erforderlich
last_executed_at
string<date-time> | null
erforderlich
created_at
string<date-time>
erforderlich
updated_at
string<date-time>
erforderlich
last_error_at
string<date-time> | null
erforderlich
last_error_message
string | null
erforderlich
consecutive_failures
integer
erforderlich
notify_on
enum<string>
erforderlich
Verfügbare Optionen:
always,
failure,
never
agent
enum<string>
erforderlich
Verfügbare Optionen:
devin,
data_analyst
last_edited_by
string | null
skill_ref
SkillReference · object | null

Der konkret verwendete Skill für die Sitzungen. Für neue Konfigurationen anstelle von playbook_id verwenden.

interval_count
integer
Standard:1
schedule_type
enum<string>
Standard:recurring
Verfügbare Optionen:
recurring,
one_time
scheduled_at
string<date-time> | null
bypass_approval
boolean
Standard:false
slack_channel_id
string | null
slack_team_id
string | null
tags
string[] | null
target_devin_id
string | null
platform
string | null