Skip to main content
PATCH
Mettre à jour l’automatisation

Autorisations

Nécessite un utilisateur de service disposant de l’autorisation ManageOrgAutomations au niveau de l’organisation.

Sémantique de fusion

Avec la sémantique 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

Réajouter un déclencheur 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

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

automation_id
string
requis
org_id
string
requis

ID d’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

application/json

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é.

actions
(AutomationStartSessionActionUpdate · object | AutomationMessageSessionActionUpdate · object | AutomationMonitorSessionActionUpdate · object)[] | null
concurrency
AutomationConcurrency · object | null
enabled
boolean | null
limits
AutomationLimits · object | null
metadata
Metadata · object | null
name
string | null
Required string length: 1 - 500
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identité 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.

security_profile
AutomationSecurityProfileSelection · object | null

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é.

session_settings
AutomationSessionSettings · object | null

Appliqué à chaque session créée par cette automatisation (y compris les sessions de surveillance).

tools
AutomationTools · object | null
triggers
AutomationTriggerRequest · object[] | null

Réponse

Réponse réussie

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
requis
automation_id
string
requis
created_at
integer
requis
created_by
ActorResponse · object
requis

Un principal d’utilisateur ou d’utilisateur de service associé à une action ou une ressource.

enabled
boolean
requis
name
string
requis
triggers
AutomationTriggerResponse · object[]
requis
updated_at
integer
requis
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

Un principal d’utilisateur ou d’utilisateur de service associé à une action ou une ressource.

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

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.

security_profile
AutomationSecurityProfileResponse · object | null

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.

session_settings
AutomationSessionSettings · object | null

Appliqué à chaque session créée par cette automatisation (y compris les sessions de surveillance).

template_id
string | null
tools
AutomationTools · object | null