Atualizar automação
Atualize uma automação.
Os grupos presentes são mesclados membro a membro por padrão (RFC 7396): membros omitidos mantêm seu valor armazenado, e valores nulos explícitos os removem. A associação a listas é substituída integralmente, e cada elemento enviado é mesclado ao elemento armazenado do mesmo tipo quando esse tipo ocorre exatamente uma vez em ambos os lados.
Permissões
ManageOrgAutomations no nível da organização.
Semântica de merge
merge_patch, os campos PATCH fazem merge membro a membro (no estilo da RFC 7396): membros omitidos mantêm o valor armazenado, nulos explícitos limpam valores e grupos vazios não geram alterações. Os metadados fazem merge por chave, e valores nulos excluem chaves. As listas são substituídas integralmente, enquanto cada elemento enviado faz merge com o elemento armazenado do mesmo tipo quando esse tipo ocorre exatamente uma vez nos dois lados.
Na semântica replace_groups, nada faz merge: um grupo de objetos enviado substitui integralmente o grupo armazenado, e uma lista enviada de triggers ou actions substitui integralmente a lista armazenada, sem merge elemento a elemento. Reenvie todos os membros que quiser manter — membros omitidos são limpos ou redefinidos para o valor padrão. metadata também é um conjunto de substituição completa; portanto, remover uma chave significa reenviar o conjunto sem ela. Valores nulos de metadados são rejeitados com um 400, em vez de excluir chaves. Campos de nível superior omitidos permanecem inalterados.
Verifique o campo update_semantics do endpoint de esquemas de eventos para identificar a semântica ativa na sua organização antes de depender de qualquer um desses comportamentos. Trate-o como um enum aberto e aceite valores além dos dois mencionados acima.
Gatilhos de webhook
webhook:incoming gera um novo segredo e o retorna na resposta de atualização. Essa é a única vez que o segredo é exibido, portanto, salve-o ao recebê-lo. Substituir ou manter um gatilho de webhook existente preserva o segredo atual.Autorizações
Credencial de usuário de serviço (prefixo: cog_)
Parâmetros de caminho
ID da organização (prefixo: org-)
"org-abc123def456"
Corpo
Por padrão, os campos PATCH são mesclados propriedade por propriedade: propriedades omitidas são mantidas,
nulls explícitos limpam valores e grupos vazios não têm efeito. Os metadados são mesclados por chave,
com valores null excluindo chaves. As listas são substituídas integralmente (exclusão = reenviar
a lista sem o elemento), enquanto cada elemento enviado é mesclado com o
elemento armazenado do mesmo tipo quando esse tipo ocorre exatamente uma vez em ambos
os lados. Propriedades de elementos obrigatórias na criação (prompt,
setup_prompt, as configurações de Slack de monitoramento/triagem, scan_id) podem ser
omitidas quando existe uma contraparte — são mantidas como qualquer outra propriedade;
null explícito é rejeitado.
- AutomationStartSessionActionUpdate
- AutomationMessageSessionActionUpdate
- AutomationMonitorSessionActionUpdate
1 - 500Identidade 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 (no escopo do usuário) não podem ser selecionados, e mudar uma automação para organization os remove de sua seleção. creator: automação pessoal — é executada com as permissões do próprio criador e é visível apenas para o criador e administradores da organização; rejeitada para automações criadas por usuário de serviço. Obrigatório na criação; null na atualização redefine para organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
A associação de perfil de segurança da própria automação: um profile_id fixa esse perfil, {"profile_id": null} registra uma desativação explícita, e null explícito volta a herdar da organização/Enterprise. Exige a permissão de gerenciamento de perfis de segurança.
Aplicado a todas as sessões geradas por esta automação (incluindo sessões de monitoramento).
Resposta
Resposta bem-sucedida
- AutomationStartSessionAction
- AutomationMessageSessionAction
- AutomationMonitorSessionAction
Um principal de usuário ou de usuário de serviço atribuído a uma ação ou recurso.
Um principal de usuário ou de usuário de serviço atribuído a uma ação ou recurso.
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. Obrigatório na criação; null na atualização redefine para organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
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.
Aplicado a todas as sessões geradas por esta automação (incluindo sessões de monitoramento).

