Pular para o conteúdo principal
POST
Criar automação

Permissões

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

Identidade de execução

O campo run_as é obrigatório. As automações criadas por usuários de serviço devem usar organization; usuários humanos que fazem chamadas à API e têm a permissão UsePersonalAutomations podem usar creator para executar sessões com as permissões do criador.

Gatilhos e ações

Uma automação é acionada quando qualquer um dos seus triggers corresponde a um evento e, em seguida, executa suas actions (por exemplo, iniciando uma sessão do Devin com um prompt). Use o endpoint de esquemas de eventos para identificar os tipos de eventos de gatilho compatíveis, seus campos e operadores de condição e os verbos de resposta aceitos por cada tipo de evento. As conditions de gatilho usam uma estrutura de dois níveis — {"any": [{"all": [...]}]} — com condições no formato {field, operator, value}; um objeto de condições null corresponde a todos os eventos.

Gatilhos de webhook

Uma automação com um gatilho webhook:incoming (no máximo um) recebe uma URL de entrada e um segredo no momento da criação. O segredo é gerado novamente e retornado quando um gatilho de webhook é readicionado durante uma atualização; ele não pode ser recuperado novamente, portanto, guarde-o ao recebê-lo. Sistemas externos o enviam no cabeçalho X-Webhook-Secret.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

org_id
string
obrigatório

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

Exemplo:

"org-abc123def456"

Corpo

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

É acionado quando qualquer acionador corresponde; uma vez por evento. No máximo um acionador webhook:incoming.

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
obrigatório

Não vazio. Limites: no máximo um start_session; monitor_session deve ser a única ação.

run_as
AutomationRunAsOrganization · object
obrigatório

Obrigatório: escolha explicitamente a identidade sob a qual as sessões geradas serão executadas (organization, creator ou service_user).

enabled
boolean
padrão:true
notifications
AutomationNotifications · object | null
tools
AutomationTools · object | null
metadata
Metadata · object

Rótulos de chave/valor visíveis na organização para organizar ou filtrar automações. No máximo 16 pares; chaves com até 32 caracteres; valores com até 128.

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

Aplicado às sessões geradas por esta automação.

security_profile
AutomationSecurityProfileSelection · object | null

A vinculação da própria automação ao perfil de segurança; omitido = herda da organização/Enterprise. Requer a permissão de gerenciamento de perfis de segurança.

slack_reply_access
enum<string>
padrão:slack_users

Quem pode responder em sessões existentes a partir de threads do Slack: devin_users (somente 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 a partir de threads do Microsoft Teams: devin_users (somente 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

Marcador de procedência apenas para criação; resolva IDs pelo endpoint templates. Quando definido e tools.mcp_servers for omitido, os required_mcps do template serão aplicados.

script_check
AutomationScriptCheckRequest · object | null

Verificação Preflight opcional por script: um script executado antes das ações que decide, a cada acionamento, se deve prosseguir, pular ou ramificar a execução. O script é validado e salvo junto com a automação.

llm_check
AutomationLlmCheckRequest · object | null

Verificação opcional por LLM: um modelo rápido que decide, a cada evento de acionamento, se a automação será executada.

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.