Skip to main content
PATCH
Actualizar automatización

Permisos

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

Semántica de fusión

Con la semántica predeterminada merge_patch, los campos PATCH se fusionan por miembro (al estilo de RFC 7396): los miembros omitidos conservan su valor almacenado, los valores nulos explícitos se borran y los grupos vacíos son operaciones sin efectos. Los metadatos se fusionan por clave y los valores nulos eliminan claves. Las listas se reemplazan por completo, mientras que cada elemento enviado se fusiona con el elemento almacenado del mismo tipo cuando ese tipo aparece exactamente una vez en ambos lados. Con la semántica replace_groups, no se fusiona nada: un grupo de objetos enviado reemplaza por completo al grupo almacenado, y una lista enviada de triggers o actions reemplaza por completo la lista almacenada, sin fusiones por elemento. Reenvía todos los miembros que quieras conservar; los miembros omitidos se borran o se restablecen a su valor predeterminado. metadata también se reemplaza por completo, por lo que eliminar una clave implica reenviar el conjunto sin ella; los valores nulos en los metadatos se rechazan con un 400 en lugar de eliminar claves. Los campos de nivel superior omitidos no cambian. Antes de basarte en cualquiera de los dos comportamientos, consulta el campo update_semantics del endpoint de esquemas de eventos para conocer la semántica activa en tu organización. Trátalo como una enumeración abierta y admite valores distintos de los dos anteriores.

Activadores de webhook

Al volver a agregar un activador webhook:incoming, se genera un secreto nuevo y se devuelve en la respuesta de actualización. Esta es la única vez que se muestra el secreto, así que guárdalo cuando lo recibas. Reemplazar o conservar un activador de webhook existente mantiene el secreto actual.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

automation_id
string
requerido
org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

application/json

Los campos PATCH se fusionan por miembro de forma predeterminada: se conservan los miembros omitidos, los valores null explícitos se borran y los grupos vacíos no producen ningún efecto. Los metadatos se fusionan por clave, y los valores null eliminan claves. Las listas se reemplazan por completo (eliminación = reenviar la lista sin el elemento), mientras que cada elemento enviado se fusiona con el elemento almacenado del mismo tipo cuando ese tipo aparece exactamente una vez en ambos lados. Los miembros de elementos obligatorios al crear (prompt, setup_prompt, las configuraciones de Slack de monitor/triaje, scan_id) pueden omitirse cuando existe una contraparte; se conservan como cualquier otro miembro; se rechaza null explícito.

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

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

security_profile
AutomationSecurityProfileSelection · object | null

La asociación de perfil de seguridad de la propia automatización: un profile_id fija ese perfil, {"profile_id": null} registra una exclusión explícita y null explícito revierte a la herencia de la organización o Enterprise. Requiere el permiso de gestión de perfiles de seguridad.

session_settings
AutomationSessionSettings · object | null

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

tools
AutomationTools · object | null
triggers
AutomationTriggerRequest · 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