Skip to main content
GET
Obtener esquemas de eventos de automatización

Permisos

Requiere un usuario de servicio o un token de acceso personal que tenga el permiso ViewOrgAutomations a nivel de organización.

Uso

Llame a este endpoint antes de crear automatizaciones: devuelve todos los tipos de eventos desencadenantes compatibles (agrupados por origen y, después, por nombre de evento), junto con sus campos de payload, los operadores admitidos por sus condiciones y los verbos replies válidos, para que pueda crear triggers válidos para los endpoints de creación y actualización. Se omiten los orígenes que no están habilitados para la organización.

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"

Parámetros de consulta

security_profile_id
string | null

Resolver default_net_policy y security_profile para una operación de creación que asigne el ID de este perfil a security_profile.profile_id. Requiere el permiso de gestión de perfiles de seguridad.

Respuesta

Respuesta correcta

default_net_policy
AutomationNetPolicy · object | null
requerido

Política de red que los clientes deben usar como punto de partida para nuevas automatizaciones: la política del despliegue que solo permite Git Manager (añada únicamente los destinos que requiere la tarea) o null si el perfil de seguridad que las rige (consulte security_profile) tiene una política de red. En ese caso, las sesiones usan la política del perfil; omita session_settings.net_policy a menos que la tarea requiera restricciones adicionales.

sources
Sources · object
requerido

Origen del evento → nombre del evento → esquema.

update_semantics
string
requerido

Semántica PATCH activa para esta organización: 'replace_groups' (un grupo de configuración presente en la solicitud reemplaza por completo al grupo almacenado) o 'merge_patch' (RFC 7396 para objetos: los miembros omitidos de un grupo presente conservan sus valores almacenados; los valores null explícitos los borran; la pertenencia a listas sigue reemplazándose por completo —la eliminación consiste en reenviar la lista sin el elemento—, pero cada elemento enviado se fusiona con el elemento almacenado del mismo tipo cuando ese tipo aparece exactamente una vez en ambos lados; los tipos repetidos deben volver a declararse íntegramente). Enumeración abierta: los clientes deben admitir valores nuevos.

security_profile
AutomationSchemasSecurityProfile · object | null

Perfil de seguridad que rige las sesiones de automatización de esta organización, o null si no se aplica ninguno.