Vai al contenuto principale
GET
Recupera automazione

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ViewOrgAutomations a livello dell’organizzazione.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale utente di servizio (prefisso: cog_)

Parametri del percorso

automation_id
string
obbligatorio
org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

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.