Skip to main content
POST
Crear automatización

Permisos

Requiere un usuario de servicio con el permiso ManageOrgAutomations a nivel de organización.

Identidad de ejecución

El campo run_as es obligatorio. Las automatizaciones creadas por usuarios de servicio deben usar organization; quienes realizan llamadas a la API y son propietarios humanos con el permiso UsePersonalAutomations pueden usar creator para ejecutar sesiones con los permisos del creador.

Desencadenadores y acciones

Una automatización se activa cuando cualquiera de sus triggers coincide con un evento y, a continuación, ejecuta sus actions (por ejemplo, iniciando una sesión de Devin con un prompt). Usa el endpoint de esquemas de eventos para consultar los tipos de eventos desencadenadores compatibles, sus campos y operadores de condición, y los verbos de respuesta que admite cada tipo de evento. Las conditions de los desencadenadores usan una estructura envolvente de dos niveles — {"any": [{"all": [...]}]} — de condiciones {field, operator, value}; un objeto conditions con valor null coincide con todos los eventos.

Desencadenadores de webhook

A una automatización con un desencadenador webhook:incoming (como máximo uno) se le asignan una URL de bandeja de entrada y un secreto al crearla. El secreto se genera de nuevo y se devuelve al volver a agregar un desencadenador de webhook durante una actualización; no puede volver a recuperarse, así que guárdalo cuando lo recibas. Los sistemas externos lo envían en el encabezado X-Webhook-Secret.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

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

No vacío. Límites: como máximo un start_session; monitor_session debe ser la única acción.

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

Obligatorio: elija explícitamente la identidad bajo la que se ejecutarán las sesiones creadas (organización o creador).

triggers
AutomationTriggerRequest · object[]
requerido

Se activa cuando coincide cualquier activador; una vez por evento. Como máximo, un activador webhook:incoming.

concurrency
AutomationConcurrency · object | null
enabled
boolean
predeterminado:true
limits
AutomationLimits · object | null
metadata
Metadata · object

Etiquetas clave-valor visibles en la organización para organizar y filtrar automatizaciones. Como máximo, 16 pares; claves de hasta 32 caracteres y valores de hasta 128.

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

La asociación de la automatización con un perfil de seguridad; si se omite, se hereda de la organización/empresa. Requiere el permiso para gestionar perfiles de seguridad.

session_settings
AutomationSessionSettings · object | null

Se aplica a las sesiones que crea esta automatización.

template_id
string | null

Marcador de procedencia solo para la creación; resuelva los ID mediante el endpoint de templates. Si se establece y se omite tools.mcp_servers, se aplican los required_mcps del template.

tools
AutomationTools · object | null

Respuesta

Respuesta correcta

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

Una entidad principal de usuario o de usuario de servicio asociada a una acción o un recurso.

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

Una entidad principal de usuario o de usuario de servicio asociada a una acción o un recurso.

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

Identidad bajo la que se ejecutan las sesiones creadas. organization: la identidad de automatización de la organización (el Usuario del sistema en la app) — las sesiones usan permisos del sistema, por lo que no se pueden seleccionar servidores MCP instalados con una conexión personal (de ámbito de usuario), y cambiar una automatización a organization los elimina de la selección. creator: automatización personal — se ejecuta con los permisos del creador y solo pueden verla el creador y los Admin de org; se rechaza para automatizaciones creadas por usuarios de servicio. Obligatorio al crear; null al actualizar restablece organization.

security_profile
AutomationSecurityProfileResponse · object | null

La asociación de la automatización con un perfil de seguridad y los perfiles rectores resultantes. null cuando los perfiles de seguridad no están habilitados para la organización.

session_settings
AutomationSessionSettings · object | null

Se aplica a cada sesión que crea esta automatización (incluidas las sesiones de monitorización).

template_id
string | null
tools
AutomationTools · object | null