Pular para o conteúdo principal
GET
Obter automação

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ViewOrgAutomations no nível da organização.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

automation_id
string
obrigatório
org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Resposta

Resposta bem-sucedida

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

Um principal de usuário ou de usuário de serviço atribuído a uma ação ou recurso.

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

Aplicada a todas as sessões geradas por esta automação (incluindo sessões de monitoramento).

security_profile
AutomationSecurityProfileResponse · object | null

A vinculação da automação a perfis de segurança e os perfis aplicáveis resolvidos. null quando os perfis de segurança não estão ativados para a organização.

run_as
AutomationRunAsOrganization · object

Identidade sob a qual as sessões criadas serão executadas. organization: a identidade de automação da organização. Quando a organização tem um usuário de serviço padrão para automações, as sessões são executadas como esse usuário de serviço e a resposta retorna run_as service_user com seu id; para salvar, é necessário ter todas as permissões desse usuário de serviço. Sem um usuário de serviço padrão, não é possível criar uma automação nem salvar uma automação ativada. Servidores MCP instalados com uma conexão pessoal (com escopo de usuário) aos quais esse usuário de serviço não se conectou não podem ser selecionados, e alternar uma automação para organization os remove da seleção. creator: automação pessoal — é executada com as permissões do criador e é visível apenas para ele e para os administradores da organização; rejeitada para automações criadas por usuários de serviço. service_user: é executada como o usuário de serviço especificado, com suas funções, concessões de acesso e limites de ACU; exige permissão para gerenciar esse usuário de serviço. Obrigatório na criação; null na atualização redefine para organization.

slack_reply_access
enum<string>
padrão:slack_users

Quem pode responder em sessões existentes por meio de threads do Slack: devin_users (apenas contas do Devin vinculadas), slack_users (qualquer pessoa nos workspaces do Slack conectados à organização) ou external_slack_users (inclui também usuários do Slack Connect). Não afeta quem pode acionar a automação.

Opções disponíveis:
devin_users,
slack_users,
external_slack_users
teams_reply_access
enum<string>
padrão:teams_users

Quem pode responder em sessões existentes por meio de threads do Microsoft Teams: devin_users (apenas contas do Devin vinculadas) ou teams_users (qualquer pessoa no tenant da Microsoft conectado à organização; opção padrão). Não afeta quem pode acionar a automação.

Opções disponíveis:
devin_users,
teams_users
template_id
string | null
last_edited_by
ActorResponse · object | null

Um principal de usuário ou de usuário de serviço atribuído a uma ação ou recurso.

last_invocation
AutomationLastInvocation · object | null
next_run_at
integer | null

Quando ocorrerão os próximos disparos dos agendamentos que acionam a automação. null quando nenhum agendamento aciona a automação, ela está desativada ou todos os agendamentos já passaram da data de término.