Skip to main content
POST
Créer une automatisation

Autorisations

Requiert un utilisateur de service disposant de l’autorisation ManageOrgAutomations au niveau de l’organisation.

Identité d’exécution

Le champ run_as est obligatoire. Les automatisations créées par des utilisateurs de service doivent utiliser organization ; les appelants humains de l’API disposant de l’autorisation UsePersonalAutomations peuvent utiliser creator pour exécuter des sessions avec les autorisations du créateur.

Déclencheurs et actions

Une automatisation se déclenche lorsque l’un de ses triggers correspond à un événement, puis exécute ses actions (par exemple, en lançant une session Devin avec un prompt). Utilisez l’endpoint des schémas d’événements pour connaître les types d’événements déclencheurs pris en charge, leurs champs de condition et opérateurs, ainsi que les verbes de réponse pris en charge par chaque type d’événement. Les conditions d’un déclencheur utilisent une enveloppe à deux niveaux — {"any": [{"all": [...]}]} — composée de conditions {field, operator, value} ; un objet conditions défini sur null correspond à tous les événements.

Déclencheurs webhook

Une automatisation comportant un déclencheur webhook:incoming (un seul au maximum) reçoit une URL de boîte de réception et un secret lors de sa création. Le secret est régénéré et renvoyé lorsqu’un déclencheur webhook est ajouté de nouveau lors d’une mise à jour ; il ne peut pas être récupéré ultérieurement. Veillez donc à l’enregistrer lorsque vous le recevez. Les systèmes externes l’envoient dans l’en-tête X-Webhook-Secret.

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

org_id
string
requis

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

Exemple:

"org-abc123def456"

Corps

application/json
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
requis

Non vide. Limites : au plus un start_session ; monitor_session doit être la seule action.

name
string
requis
Required string length: 1 - 500
run_as
AutomationRunAsOrganization · object
requis

Obligatoire : choisissez explicitement l’identité sous laquelle s’exécutent les sessions générées (organisation ou créateur).

triggers
AutomationTriggerRequest · object[]
requis

Se déclenche lorsqu’un déclencheur correspond, une fois par événement. Au plus un déclencheur webhook:incoming.

concurrency
AutomationConcurrency · object | null
enabled
boolean
défaut:true
limits
AutomationLimits · object | null
metadata
Metadata · object

Libellés clé/valeur visibles au niveau de l’organisation pour organiser et filtrer les automatisations. Au plus 16 paires ; clés de 32 caractères au maximum ; valeurs de 128 au maximum.

notifications
AutomationNotifications · object | null
security_profile
AutomationSecurityProfileSelection · object | null

La liaison au profil de sécurité propre à l’automatisation ; si omise, héritée de l’organisation/de l’entreprise. Nécessite l’autorisation de gestion des profils de sécurité.

session_settings
AutomationSessionSettings · object | null

Appliqué aux sessions générées par cette automatisation.

template_id
string | null

Marqueur de provenance utilisable uniquement à la création ; résolvez les ID via l’endpoint templates. Lorsqu’il est défini et que tools.mcp_servers est omis, les required_mcps du modèle s’appliquent.

tools
AutomationTools · 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