Skip to main content
POST
Crea un'automazione

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageOrgAutomations a livello dell’organizzazione.

Identità di esecuzione

Il campo run_as è obbligatorio. Le automazioni create da utenti di servizio devono usare organization; i chiamanti API gestiti da persone con l’autorizzazione UsePersonalAutomations possono usare creator per eseguire sessioni con le autorizzazioni del creatore.

Trigger e azioni

Un’automazione si attiva quando uno dei suoi triggers corrisponde a un evento ed esegue quindi le relative actions (ad esempio, avviando una sessione Devin con un prompt). Utilizza l’endpoint degli schemi degli eventi per scoprire i tipi di eventi trigger supportati, i relativi campi delle condizioni e operatori, nonché i verbi di risposta supportati da ciascun tipo di evento. Le conditions dei trigger utilizzano una struttura a due livelli — {"any": [{"all": [...]}]} — composta da condizioni {field, operator, value}; un oggetto conditions con valore null corrisponde a qualsiasi evento.

Trigger webhook

A un’automazione con un trigger webhook:incoming (al massimo uno) vengono assegnati un URL di ricezione e un segreto al momento della creazione. Il segreto viene rigenerato e restituito quando un trigger webhook viene aggiunto nuovamente durante un aggiornamento; non può essere recuperato in seguito, quindi salvalo quando lo ricevi. I sistemi esterni lo inviano nell’header X-Webhook-Secret.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

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

Non vuoto. Limiti: al massimo un start_session; monitor_session deve essere l'unica action.

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

Obbligatorio: scegliere esplicitamente l'identità con cui vengono eseguite le sessioni generate (organizzazione o creatore).

triggers
AutomationTriggerRequest · object[]
obbligatorio

Si attiva quando corrisponde un trigger, una volta per evento. È consentito al massimo un trigger webhook:incoming.

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

Etichette chiave/valore visibili nell'org per organizzare o filtrare le automazioni. Al massimo 16 coppie; chiavi di massimo 32 caratteri; valori di massimo 128.

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

L'associazione dell'automazione al profilo di sicurezza; se omessa, viene ereditata dall'org/enterprise. Richiede l'autorizzazione per la gestione dei profili di sicurezza.

session_settings
AutomationSessionSettings · object | null

Applicato alle sessioni generate da questa automazione.

template_id
string | null

Indicatore di provenienza solo in fase di creazione; risolvi gli ID tramite l'endpoint templates. Se impostato e tools.mcp_servers è omesso, si applicano i required_mcps del template.

tools
AutomationTools · object | null

Risposta

Risposta riuscita

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

Un principal utente o utente di servizio associato a un'azione o a una risorsa.

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

Un principal utente o utente di servizio associato a un'azione o a una risorsa.

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

Identità con cui vengono eseguite le sessioni generate. organization: l'identità di automazione dell'org (l'Utente di sistema nell'app) — le sessioni usano autorizzazioni di sistema, quindi non è possibile selezionare server MCP installati con una connessione personale (con ambito utente); passando un'automazione a organization, tali server vengono rimossi dalla selezione. creator: automazione personale — viene eseguita con le autorizzazioni del creatore ed è visibile solo al creatore e agli admin dell'org; non consentita per le automazioni create da utenti di servizio. Obbligatorio alla creazione; null in aggiornamento reimposta a organization.

security_profile
AutomationSecurityProfileResponse · object | null

L'associazione dell'automazione al profilo di sicurezza e i profili applicabili risultanti. null quando i profili di sicurezza non sono abilitati per l'organizzazione.

session_settings
AutomationSessionSettings · object | null

Applicato a ogni sessione generata da questa automazione (incluse le sessioni di monitoraggio).

template_id
string | null
tools
AutomationTools · object | null