Saltar al contenido principal
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.

available_devin_modes
enum<string>[]

Modos que session_settings.devin_mode acepta actualmente para una nueva selección usando la identidad de automatización de la organización: los modos estables con los que puede crear sesiones y, cuando el despliegue de vistas previas de la organización lo permite, las vistas previas de investigación. Un modo almacenado que no figure en esta lista se conserva al realizar modificaciones que no lo cambien.

Opciones disponibles:
normal,
fast,
lite,
ultra,
fusion,
swe-2-medium,
swe-2-high,
swe-2-max
default_fallback_devin_mode
enum<string> | null

Modo estable que se usa como valor inicial de session_settings.fallback_devin_mode cuando se selecciona una vista previa de investigación: el modo predeterminado de la organización si es estable y está disponible; en caso contrario, el primer modo estable disponible; null si no hay ninguno disponible.

Opciones disponibles:
normal,
fast,
lite,
ultra,
fusion
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.