Mettre à jour l’automatisation
Mettre à jour une automatisation.
Les groupes présents sont fusionnés membre par membre par défaut (RFC 7396) : les membres omis conservent leur valeur enregistrée et les valeurs nulles explicites les effacent. L’appartenance aux listes est entièrement remplacée, et chaque élément envoyé est fusionné avec l’élément enregistré du même type lorsque ce type apparaît exactement une fois de chaque côté.
Autorisations
ManageOrgAutomations au niveau de l’organisation.
Sémantique de fusion
merge_patch par défaut, les champs PATCH sont fusionnés membre par membre (selon le style de la RFC 7396) : les membres omis conservent leur valeur enregistrée, les valeurs null explicites les effacent et les groupes vides sont sans effet. Les métadonnées sont fusionnées par clé, les valeurs null supprimant les clés. Les listes sont remplacées dans leur intégralité, tandis que chaque élément envoyé est fusionné avec l’élément enregistré du même type lorsque ce type apparaît exactement une fois de chaque côté.
Avec la sémantique replace_groups, aucune fusion n’a lieu : un groupe d’objets envoyé remplace intégralement le groupe enregistré, et une liste triggers ou actions envoyée remplace intégralement la liste enregistrée, sans fusion élément par élément. Renvoyez chaque membre que vous souhaitez conserver : les membres omis sont effacés ou réinitialisés à leur valeur par défaut. metadata constitue également un remplacement complet ; pour supprimer une clé, renvoyez l’ensemble sans cette clé ; les valeurs null dans les métadonnées sont rejetées avec une erreur 400 au lieu de supprimer les clés. Les champs de niveau supérieur omis restent toutefois inchangés.
Vérifiez le champ update_semantics de l’endpoint des schémas d’événements afin de connaître la sémantique active pour votre organisation avant de vous appuyer sur l’un ou l’autre comportement. Traitez-le comme une énumération ouverte et acceptez des valeurs autres que les deux ci-dessus.
Déclencheurs de webhook
webhook:incoming génère un nouveau secret et le renvoie dans la réponse de mise à jour. Le secret n’est affiché qu’à ce moment-là : veillez donc à le récupérer dès réception. Le remplacement ou la conservation d’un déclencheur de webhook existant préserve le secret existant.Autorisations
Identifiant de compte de service (préfixe : cog_)
Paramètres de chemin
ID d’organisation (préfixe : org-)
"org-abc123def456"
Corps
Par défaut, les champs PATCH sont fusionnés membre par membre : les membres omis sont conservés,
les null explicites les effacent et les groupes vides n'ont aucun effet. Les métadonnées sont fusionnées par clé,
les valeurs null supprimant les clés. Les listes sont entièrement remplacées (suppression = renvoyer
la liste sans l'élément), tandis que chaque élément envoyé est fusionné avec l'élément
enregistré du même type lorsque ce type apparaît exactement une fois des deux
côtés. Les membres d'éléments obligatoires à la création (prompt,
setup_prompt, les configurations Slack de surveillance/triage, scan_id) peuvent être
omis lorsqu'un équivalent existe — ils sont conservés comme tout autre membre ;
un null explicite est refusé.
- AutomationStartSessionActionUpdate
- AutomationMessageSessionActionUpdate
- AutomationMonitorSessionActionUpdate
1 - 500Identité sous laquelle les sessions générées s’exécutent. organization : l’identité d’automatisation de l’organisation (l’utilisateur système dans l’application) — les sessions utilisent les autorisations système ; les serveurs MCP installés avec une connexion personnelle (limitée à l’utilisateur) ne peuvent donc pas être sélectionnés, et le passage d’une automatisation à organization les retire de sa sélection. creator : automatisation personnelle — s’exécute avec les propres autorisations du créateur et n’est visible que par le créateur et les administrateurs de l’organisation ; refusée pour les automatisations créées par un utilisateur de service. Obligatoire à la création ; null lors d’une mise à jour réinitialise à organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
La liaison de l’automatisation à son profil de sécurité : un profile_id verrouille ce profil, {"profile_id": null} enregistre une désactivation explicite, et un null explicite rétablit l’héritage depuis l’organisation/l’Enterprise. Nécessite l’autorisation de gérer les profils de sécurité.
Appliqué à chaque session créée par cette automatisation (y compris les sessions de surveillance).
Réponse
Réponse réussie
- AutomationStartSessionAction
- AutomationMessageSessionAction
- AutomationMonitorSessionAction
Un principal d’utilisateur ou d’utilisateur de service associé à une action ou une ressource.
Un principal d’utilisateur ou d’utilisateur de service associé à une action ou une ressource.
Identité sous laquelle s’exécutent les sessions générées. organization: l’identité d’automatisation de l’organisation (l’utilisateur système dans l’application) — les sessions utilisent les autorisations système ; les serveurs MCP installés avec une connexion personnelle (limitée à l’utilisateur) ne peuvent donc pas être sélectionnés, et le passage d’une automatisation à organization les retire de sa sélection. creator: automatisation personnelle — s’exécute avec les autorisations propres au créateur et n’est visible que par celui-ci et les administrateurs de l’organisation ; refusée pour les automatisations créées par un utilisateur de service. Obligatoire à la création ; null lors d’une mise à jour réinitialise la valeur sur organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
La liaison au profil de sécurité de l’automatisation et les profils directeurs résolus. null lorsque les profils de sécurité ne sont pas activés pour l’organisation.
Appliqué à chaque session créée par cette automatisation (y compris les sessions de surveillance).

