Skip to main content
POST
Automatisierung erstellen

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken 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 (organization, creator oder service_user).

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.

slack_reply_access
enum<string>
Standard:slack_users

Wer aus Slack-Threads in bestehenden Sitzungen antworten darf: devin_users (nur verknüpfte Devin-Konten), slack_users (alle Personen in den verbundenen Slack-Workspaces der Organisation) oder external_slack_users (auch Slack Connect-Nutzer). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
Standard:teams_users

Wer aus Microsoft Teams-Threads in bestehenden Sitzungen antworten darf: devin_users (nur verknüpfte Devin-Konten) oder teams_users (alle Personen im verbundenen Microsoft-Mandanten der Organisation; Standardeinstellung). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
teams_users
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
next_run_at
integer | null

Zeitpunkt, zu dem die Zeitplan-Auslöser der Automatisierung das nächste Mal auslösen. null, wenn die Automatisierung keinen Zeitplan-Auslöser hat, deaktiviert ist oder das Enddatum aller Zeitpläne überschritten ist.

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. service_user: wird als angegebener Service-Benutzer mit dessen Rollen, Zugriffsrechten und ACU-Limits ausgeführt; erfordert die Berechtigung zur Verwaltung dieses Service-Benutzers. 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).

slack_reply_access
enum<string>
Standard:slack_users

Wer über Slack-Threads in bestehenden Sitzungen antworten darf: devin_users (nur verknüpfte Devin-Konten), slack_users (alle Nutzer in den verbundenen Slack-Workspaces der Organisation) oder external_slack_users (auch Slack Connect-Nutzer). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
Standard:teams_users

Wer über Microsoft Teams-Threads in bestehenden Sitzungen antworten darf: devin_users (nur verknüpfte Devin-Konten) oder teams_users (alle Nutzer im verbundenen Microsoft-Mandanten der Organisation; Standard). Hat keinen Einfluss darauf, wer die Automatisierung auslösen kann.

Verfügbare Optionen:
devin_users,
teams_users
template_id
string | null
tools
AutomationTools · object | null