Vai al contenuto principale
POST
Crea automazione

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale 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 utente di servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json
name
string
obbligatorio
Required string length: 1 - 500
triggers
AutomationTriggerRequest · object[]
obbligatorio

Si attiva quando corrisponde un qualsiasi trigger, una volta per evento. Al massimo un trigger webhook:incoming.

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

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

run_as
AutomationRunAsOrganization · object
obbligatorio

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

enabled
boolean
predefinito:true
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object

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

limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

Applicato alle sessioni generate da questa automazione.

security_profile
AutomationSecurityProfileSelection · object | null

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

slack_reply_access
enum<string>
predefinito:slack_users

Chi può rispondere nelle sessioni esistenti dai thread di Slack: devin_users (solo account Devin collegati), slack_users (chiunque nei workspace Slack collegati all'organizzazione) o external_slack_users (anche gli utenti di Slack Connect). Non influisce su chi può attivare l'automazione.

Opzioni disponibili:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
predefinito:teams_users

Chi può rispondere nelle sessioni esistenti dai thread di Microsoft Teams: devin_users (solo account Devin collegati) o teams_users (chiunque nel tenant Microsoft collegato all'organizzazione; opzione predefinita). Non influisce su chi può attivare l'automazione.

Opzioni disponibili:
devin_users,
teams_users
template_id
string | null

Indicatore di provenienza utilizzabile solo in creazione; risolvere gli ID tramite l'endpoint templates. Se impostato e tools.mcp_servers è omesso, vengono applicati i required_mcps del template.

script_check
AutomationScriptCheckRequest · object | null

Controllo Preflight facoltativo tramite script: uno script eseguito prima delle azioni che decide, per ogni trigger, se procedere, saltare l'esecuzione o avviare più esecuzioni in parallelo. Viene convalidato e salvato insieme all'automazione.

llm_check
AutomationLlmCheckRequest · object | null

Controllo LLM facoltativo: un modello veloce che decide, per ogni evento trigger, se eseguire l'automazione.

Risposta

Risposta riuscita

automation_id
string
obbligatorio
name
string
obbligatorio
enabled
boolean
obbligatorio
triggers
AutomationTriggerResponse · object[]
obbligatorio
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
obbligatorio
created_by
ActorResponse · object
obbligatorio

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

created_at
integer
obbligatorio
updated_at
integer
obbligatorio
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object
limits
AutomationLimits · object | null
concurrency
AutomationConcurrency · object | null
session_settings
AutomationSessionSettings · object | null

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

security_profile
AutomationSecurityProfileResponse · object | null

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

run_as
AutomationRunAsOrganization · object

Identità con cui vengono eseguite le sessioni generate. organization: l'identità dell'automazione dell'org. Quando l'organizzazione ha un utente di servizio predefinito per le automazioni, le sessioni vengono eseguite con l'identità di tale utente di servizio e la risposta restituisce run_as service_user con il relativo id; il salvataggio richiede tutte le autorizzazioni possedute da tale utente di servizio. In assenza di tale utente, la creazione di un'automazione o il salvataggio di un'automazione abilitata vengono rifiutati. Non è possibile selezionare server MCP installati con una connessione personale (user-scoped) a cui tale utente di servizio non si è connesso; passando un'automazione a organization, questi vengono rimossi dalla relativa selezione. creator: automazione personale — viene eseguita con le autorizzazioni del creatore ed è visibile solo al creatore e agli Org admin; rifiutata per le automazioni create da utenti di servizio. service_user: viene eseguita con l'identità dell'utente di servizio indicato, con i suoi ruoli, diritti di accesso e limiti ACU; richiede l'autorizzazione a gestire tale utente di servizio. Obbligatorio alla creazione; null durante l'aggiornamento reimposta il valore a organization.

slack_reply_access
enum<string>
predefinito:slack_users

Chi può rispondere nelle sessioni esistenti dai thread di Slack: devin_users (solo account Devin collegati), slack_users (chiunque nei workspace Slack collegati all'organizzazione) o external_slack_users (anche gli utenti di Slack Connect). Non influisce su chi può attivare l'automazione.

Opzioni disponibili:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
predefinito:teams_users

Chi può rispondere nelle sessioni esistenti dai thread di Microsoft Teams: devin_users (solo account Devin collegati) o teams_users (chiunque nel tenant Microsoft collegato all'organizzazione; valore predefinito). Non influisce su chi può attivare l'automazione.

Opzioni disponibili:
devin_users,
teams_users
template_id
string | null
last_edited_by
ActorResponse · object | null

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

last_invocation
AutomationLastInvocation · object | null
next_run_at
integer | null

Quando si attiveranno la prossima volta i trigger di pianificazione dell'automazione. null se l'automazione non ha trigger di pianificazione, è disabilitata o tutte le pianificazioni hanno superato la propria data di fine.