Skip to main content
POST
Automatisierung erstellen

Berechtigungen

Erfordert einen Service-Benutzer mit der Berechtigung ManageOrgAutomations auf Organisationsebene.

Ausführungsidentität

Das Feld run_as ist erforderlich. Von Service-Nutzern erstellte Automatisierungen müssen organization verwenden; menschliche API-Aufrufer mit der Berechtigung UsePersonalAutomations können creator verwenden, um Sitzungen mit den Berechtigungen des Erstellers auszuführen.

Auslöser und Aktionen

Eine Automatisierung wird ausgelöst, wenn einer ihrer triggers auf ein Ereignis zutrifft, und führt anschließend ihre actions aus (zum Beispiel das Starten einer Devin-Sitzung mit einem Prompt). Über den Endpunkt für Ereignisschemas können Sie die unterstützten Ereignistypen für Auslöser, deren Bedingungsfelder und Operatoren sowie die Antwortverben ermitteln, die von den einzelnen Ereignistypen unterstützt werden. Die conditions eines Auslösers verwenden eine zweistufige Struktur — {"any": [{"all": [...]}]} — aus Bedingungen im Format {field, operator, value}; ein null-Bedingungsobjekt trifft auf jedes Ereignis zu.

Webhook-Auslöser

Einer Automatisierung mit einem webhook:incoming-Auslöser (maximal einer) werden beim Erstellen eine Inbox-URL und ein Secret zugewiesen. Das Secret wird neu generiert und zurückgegeben, wenn ein Webhook-Auslöser im Rahmen einer Aktualisierung erneut hinzugefügt wird. Danach kann es nicht mehr abgerufen werden. Speichern Sie es daher, sobald Sie es erhalten. Externe Systeme senden es im Header X-Webhook-Secret.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
erforderlich

Nicht leer. Beschränkungen: höchstens ein start_session; monitor_session muss die einzige Action sein.

name
string
erforderlich
Required string length: 1 - 500
run_as
AutomationRunAsOrganization · object
erforderlich

Erforderlich: Explizit auswählen, unter welcher Identität gestartete Sitzungen ausgeführt werden (Organisation oder Ersteller).

triggers
AutomationTriggerRequest · object[]
erforderlich

Wird ausgelöst, wenn ein Trigger übereinstimmt; einmal pro Ereignis. Höchstens ein webhook:incoming-Trigger.

concurrency
AutomationConcurrency · object | null
enabled
boolean
Standard:true
limits
AutomationLimits · object | null
metadata
Metadata · object

Organisationsweit sichtbare Schlüssel-Wert-Labels zum Organisieren und Filtern von Automatisierungen. Höchstens 16 Paare; Schlüssel höchstens 32 Zeichen; Werte höchstens 128 Zeichen.

notifications
AutomationNotifications · object | null
security_profile
AutomationSecurityProfileSelection · object | null

Die Sicherheitsprofilbindung der Automatisierung; ausgelassen = von der Organisation bzw. dem Enterprise geerbt. Erfordert die Berechtigung zum Verwalten von Sicherheitsprofilen.

session_settings
AutomationSessionSettings · object | null

Wird auf Sitzungen angewendet, die von dieser Automatisierung gestartet werden.

template_id
string | null

Herkunftsmarker nur beim Erstellen; IDs über den Templates-Endpunkt auflösen. Wenn gesetzt und tools.mcp_servers ausgelassen wird, gelten die required_mcps des Templates.

tools
AutomationTools · object | null

Antwort

Erfolgreiche Antwort

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
erforderlich
automation_id
string
erforderlich
created_at
integer
erforderlich
created_by
ActorResponse · object
erforderlich

Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.

enabled
boolean
erforderlich
name
string
erforderlich
triggers
AutomationTriggerResponse · object[]
erforderlich
updated_at
integer
erforderlich
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identität, unter der gestartete Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation (der System User in der App) — Sitzungen verwenden Systemberechtigungen, daher können MCP-Server mit einer persönlichen (nutzerbezogenen) Verbindung nicht ausgewählt werden; beim Umschalten einer Automatisierung auf organization werden sie aus der Auswahl entfernt. creator: persönliche Automatisierung — wird mit den Berechtigungen des Erstellers ausgeführt und ist nur für den Ersteller und Organisationsadministratoren sichtbar; für Automatisierungen, die von Service-Benutzern erstellt wurden, nicht zulässig. Beim Erstellen erforderlich; null bei Updates setzt den Wert auf organization zurück.

security_profile
AutomationSecurityProfileResponse · object | null

Die Sicherheitsprofilbindung der Automatisierung und die ermittelten maßgeblichen Profile. null, wenn Sicherheitsprofile für die Organisation nicht aktiviert sind.

session_settings
AutomationSessionSettings · object | null

Wird auf jede Sitzung angewendet, die diese Automatisierung startet (einschließlich Überwachungssitzungen).

template_id
string | null
tools
AutomationTools · object | null