Actualizar automatización
Actualiza una automatización.
Los grupos presentes se fusionan por miembro de forma predeterminada (RFC 7396): los miembros omitidos conservan su valor almacenado y los valores nulos explícitos los eliminan. La pertenencia a listas se reemplaza por completo, y cada elemento enviado se fusiona con el elemento almacenado del mismo tipo cuando ese tipo aparece exactamente una vez en ambos lados.
Permisos
ManageOrgAutomations a nivel de organización.
Semántica de fusión
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
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
Credencial de usuario de servicio (prefijo: cog_)
Parámetros de ruta
ID de organización (prefijo: org-)
"org-abc123def456"
Cuerpo
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.
- AutomationStartSessionActionUpdate
- AutomationMessageSessionActionUpdate
- AutomationMonitorSessionActionUpdate
1 - 500Identidad 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.
- AutomationRunAsOrganization
- AutomationRunAsCreator
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.
Se aplica a cada sesión que crea esta automatización (incluidas las sesiones de monitorización).
Respuesta
Respuesta correcta
- AutomationStartSessionAction
- AutomationMessageSessionAction
- AutomationMonitorSessionAction
Una entidad principal de usuario o de usuario de servicio asociada a una acción o un recurso.
Una entidad principal de usuario o de usuario de servicio asociada a una acción o un recurso.
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.
- AutomationRunAsOrganization
- AutomationRunAsCreator
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.
Se aplica a cada sesión que crea esta automatización (incluidas las sesiones de monitorización).

