Skip to main content
DELETE
Excluir 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. As exclusões são lógicas: a automação excluída é retornada no corpo da resposta.

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

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
obrigatório
automation_id
string
obrigatório
created_at
integer
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.

enabled
boolean
obrigatório
name
string
obrigatório
triggers
AutomationTriggerResponse · object[]
obrigatório
updated_at
integer
obrigatório
concurrency
AutomationConcurrency · object | 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
limits
AutomationLimits · object | null
metadata
Metadata · object
next_run_at
integer | null

Quando ocorrerá o próximo acionamento dos agendamentos da automação. null quando a automação não tem acionamento por agendamento, está desativada ou todos os agendamentos já passaram da data de término.

notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identidade sob a qual as sessões geradas são executadas. organization: a identidade de automação da organização (o Usuário do sistema no app) — as sessões usam permissões do sistema; portanto, servidores MCP instalados com uma conexão pessoal (com escopo de usuário) não podem ser selecionados, e alterar uma automação para organization os remove da seleção. creator: automação pessoal — é executada com as permissões do próprio criador e fica visível apenas para o criador e administradores da organização; rejeitada para automações criadas por usuário de serviço. service_user: é executada como o usuário de serviço indicado, com suas roles, 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.

security_profile
AutomationSecurityProfileResponse · object | null

A associação da automação ao perfil de segurança e os perfis aplicáveis determinados. null quando os perfis de segurança não estão ativados para a organização.

session_settings
AutomationSessionSettings · object | null

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

slack_reply_access
enum<string>
padrão:slack_users

Quem pode responder em sessões existentes a partir 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 a partir 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
tools
AutomationTools · object | null