> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Obtener esquemas de eventos de automatización
> Devuelve todos los esquemas de eventos de activadores compatibles, indexados por origen y luego por nombre de evento.
Cada esquema describe los campos de carga útil del evento, los operadores que admiten sus
condiciones y los verbos `replies` válidos, para que los clientes puedan
construir `triggers` válidos para los endpoints de creación y actualización.
## Permisos
Requiere un usuario de servicio 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.
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/schemas
openapi: 3.1.0
info:
description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/automations/schemas:
get:
tags:
- automations
summary: Obtener esquemas de eventos de automatización
description: >-
Devuelve todos los esquemas de eventos de activadores compatibles,
indexados por origen y luego por nombre de evento.
Cada esquema describe los campos de carga útil del evento, los
operadores que admiten sus
condiciones y los verbos `replies` válidos, para que los clientes puedan
construir `triggers` válidos para los endpoints de creación y
actualización.
operationId: >-
handle_get_automation_schemas_v3_organizations__org_id__automations_schemas_get
parameters:
- description: 'ID de organización (prefijo: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationSchemasResponse'
description: Respuesta correcta
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Prohibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflicto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenido no procesable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Demasiadas solicitudes
components:
schemas:
AutomationSchemasResponse:
additionalProperties: false
properties:
sources:
additionalProperties:
additionalProperties:
$ref: '#/components/schemas/AutomationEventSchemaResponse'
type: object
description: Origen del evento → nombre del evento → esquema.
title: Sources
type: object
update_semantics:
description: >-
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.
title: Update Semantics
type: string
required:
- update_semantics
- sources
title: AutomationSchemasResponse
type: object
ProblemDetail:
description: >-
Cuerpo de error RFC 9457 application/problem+json para la API v3.
detail se conserva del cuerpo heredado {"detail": ...} por
compatibilidad con versiones anteriores; los
otros miembros son adicionales. errors contiene errores de validación
a nivel de campo (solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explicación legible para humanos específica de esta ocurrencia.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errores de validación por campo (solo en respuestas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
title: Instance
status:
description: El código de estado HTTP.
title: Status
type: integer
title:
description: Un breve resumen del tipo de problema, legible para humanos.
title: Title
type: string
type:
default: about:blank
description: Una referencia URI que identifica el tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
AutomationEventSchemaResponse:
additionalProperties: false
properties:
category:
title: Category
type: string
event_type:
title: Event Type
type: string
fields:
additionalProperties:
$ref: '#/components/schemas/AutomationSchemaFieldDef'
description: >-
Ruta del campo de condición → definición del campo (tipo, etiqueta,
obligatorio, opciones, ...).
title: Fields
type: object
name:
title: Name
type: string
supported_replies:
description: Verbos replies[].type válidos para este tipo de evento.
items:
type: string
title: Supported Replies
type: array
required:
- event_type
- name
- category
- supported_replies
- fields
title: AutomationEventSchemaResponse
type: object
AutomationSchemaFieldDef:
additionalProperties: false
description: >-
Vista aplanada de una definición de campo de condición.
Los atributos específicos del tipo (``options``,
``min``/``max``/``unit``,
``granularity``, ``placeholder``) se rellenan solo para el
``type`` correspondiente.
properties:
description:
anyOf:
- type: string
- type: 'null'
title: Description
fixed:
default: false
title: Fixed
type: boolean
granularity:
anyOf:
- enum:
- date
- datetime
type: string
- type: 'null'
title: Granularity
label:
title: Label
type: string
max:
anyOf:
- type: number
- type: 'null'
title: Max
min:
anyOf:
- type: number
- type: 'null'
title: Min
multiple:
anyOf:
- type: boolean
- type: 'null'
title: Multiple
options:
anyOf:
- items:
$ref: '#/components/schemas/AutomationSchemaSelectOption'
type: array
- type: 'null'
title: Options
placeholder:
anyOf:
- type: string
- type: 'null'
title: Placeholder
required:
default: false
title: Required
type: boolean
type:
enum:
- string
- number
- boolean
- date
- select
- rrule
- slack_channel
- linear_team
- incident_io_team
- incident_io_severity
- incident_io_status
- incident_io_incident_type
- github_repo
- gitlab_repo
- linear_label
- linear_state
- linear_assignee
- linear_project
- jira_project
- jira_label
- jira_status
- jira_assignee
- jira_epic
- slack_user
- slack_reaction
- pylon_tag
- pylon_status
- file_paths
title: Type
type: string
unit:
anyOf:
- type: string
- type: 'null'
title: Unit
required:
- type
- label
title: AutomationSchemaFieldDef
type: object
AutomationSchemaSelectOption:
additionalProperties: false
properties:
label:
title: Label
type: string
value:
title: Value
type: string
required:
- value
- label
title: AutomationSchemaSelectOption
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````