> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Listar plantillas de automatización
> Lista las plantillas de automatización integradas.
Los valores de `template_id` se aceptan en el endpoint de creación; si se omite
`tools.mcp_servers` al crearla, se aplican los
`required_mcps` de la plantilla.
## Permisos
Requiere un usuario de servicio con el permiso `ViewOrgAutomations` en el nivel de la organización.
## Uso
Lista las plantillas de automatización integradas. El endpoint de creación acepta los valores de `template_id` como indicador de procedencia; si se omite `tools.mcp_servers` al crearla, se aplican los `required_mcps` de la plantilla.
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/templates
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/templates:
get:
tags:
- automations
summary: Listar plantillas de automatización
description: >-
Lista las plantillas de automatización integradas.
Los valores de `template_id` se aceptan en el endpoint de creación; si
se omite
`tools.mcp_servers` al crearla, se aplican los
`required_mcps` de la plantilla.
operationId: >-
handle_list_automation_templates_v3_organizations__org_id__automations_templates_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/AutomationTemplatesResponse'
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:
AutomationTemplatesResponse:
additionalProperties: false
properties:
templates:
items:
$ref: '#/components/schemas/AutomationTemplateResponse'
title: Templates
type: array
required:
- templates
title: AutomationTemplatesResponse
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
AutomationTemplateResponse:
additionalProperties: false
properties:
actions:
items:
discriminator:
mapping:
message_session:
$ref: '#/components/schemas/AutomationMessageSessionAction'
monitor_session:
$ref: '#/components/schemas/AutomationMonitorSessionAction'
start_session:
$ref: '#/components/schemas/AutomationStartSessionAction-Output'
propertyName: type
oneOf:
- $ref: '#/components/schemas/AutomationStartSessionAction-Output'
- $ref: '#/components/schemas/AutomationMessageSessionAction'
- $ref: '#/components/schemas/AutomationMonitorSessionAction'
title: Actions
type: array
category:
title: Category
type: string
description:
title: Description
type: string
docs_url:
anyOf:
- type: string
- type: 'null'
title: Docs Url
featured:
default: false
title: Featured
type: boolean
name:
title: Name
type: string
required_integrations:
items:
type: string
title: Required Integrations
type: array
required_mcps:
items:
type: string
title: Required Mcps
type: array
template_id:
title: Template Id
type: string
triggers:
items:
$ref: '#/components/schemas/AutomationTriggerRequest-Output'
title: Triggers
type: array
required:
- template_id
- name
- description
- category
- required_integrations
- required_mcps
- triggers
- actions
title: AutomationTemplateResponse
type: object
AutomationMessageSessionAction:
additionalProperties: false
properties:
auto_create:
default: false
description: >-
Cuando es true, el primer activador crea una nueva sesión de larga
duración propiedad de la automatización, y los activadores
posteriores le envían mensajes.
title: Auto Create
type: boolean
prompt:
description: La carga útil del evento desencadenante se agrega automáticamente.
title: Prompt
type: string
target_devin_id:
anyOf:
- type: string
- type: 'null'
description: >-
Debe pertenecer a la organización; editar una automatización que
contiene esta acción requiere acceso de escritura a la sesión de
destino (excepto las ediciones que solo la activan o desactivan). Es
obligatorio, salvo que auto_create sea true; en ese caso, se
establece en el servidor cuando el primer activador crea la sesión;
se ignoran los valores proporcionados por el cliente.
title: Target Devin Id
type:
const: message_session
default: message_session
title: Type
type: string
required:
- prompt
title: AutomationMessageSessionAction
type: object
AutomationMonitorSessionAction:
additionalProperties: false
properties:
setup_prompt:
description: >-
Se inyecta en el prompt del sistema de la sesión. Tiene la misma
gramática de tokens de referencia que prompt.
title: Setup Prompt
type: string
slack_monitor_config:
$ref: '#/components/schemas/AutomationSlackMonitorConfig'
description: Requiere exactamente un activador slack:message en el mismo canal.
type:
const: monitor_session
default: monitor_session
title: Type
type: string
required:
- setup_prompt
- slack_monitor_config
title: AutomationMonitorSessionAction
type: object
AutomationStartSessionAction-Output:
additionalProperties: false
properties:
prompt:
description: >-
La única fuente de verdad: texto sin formato con tokens de
referencia en línea (@{owner}/{repo}, @{path}, @playbook:{id},
@skills:{name}, !{macro}, ${SECRET_NAME}). Los tokens con prefijo de
tipo se validan al guardar; los ID desconocidos devuelven un error
400. La carga útil del evento activador se agrega automáticamente.
title: Prompt
type: string
session:
$ref: '#/components/schemas/AutomationSessionConfig-Output'
description: Configuración de la sesión creada.
type:
const: start_session
default: start_session
title: Type
type: string
required:
- prompt
title: AutomationStartSessionAction
type: object
AutomationTriggerRequest-Output:
additionalProperties: false
properties:
conditions:
anyOf:
- $ref: '#/components/schemas/AutomationConditions-Output'
- type: 'null'
description: null coincide con todos los eventos.
event_type:
description: Tipo de evento activador, p. ej., 'github:pull_request'.
enum:
- github:issue_comment
- github:issues
- github:pull_request
- github:pull_request_review
- github:pull_request_review_comment
- github:check_run
- github:push
- gitlab:merge_request
- gitlab:note
- gitlab:issue
- gitlab:issue_note
- gitlab:push
- gitlab:pipeline
- schedule:recurring
- slack:message
- slack:reaction_added
- linear:create
- linear:label_added
- linear:assigned
- linear:status_changed
- linear:priority_changed
- linear:moved
- jira:issue_created
- jira:label_added
- jira:status_changed
- jira:assigned
- pylon:issue_created
- pylon:issue_tag_added
- pylon:issue_status_changed
- incident_io:incident_created
- incident_io:status_changed
- incident_io:severity_changed
- incident_io:follow_up_created
- webhook:incoming
- snapshot_build:completed
title: Event Type
type: string
replies:
default: []
description: >-
Dónde se asocia la sesión de este activador y dónde se entrega su
respuesta. Solo se ejecutan las respuestas del activador
coincidente; todas las entradas se procesan de forma independiente y
se deduplican.
items:
$ref: '#/components/schemas/AutomationReply'
title: Replies
type: array
required:
- event_type
title: AutomationTriggerRequest
type: object
AutomationSlackMonitorConfig:
additionalProperties: false
properties:
source_channel_id:
title: Source Channel Id
type: string
team_id:
anyOf:
- type: string
- type: 'null'
title: Team Id
required:
- source_channel_id
title: AutomationSlackMonitorConfig
type: object
AutomationSessionConfig-Output:
additionalProperties: false
properties:
bypass_approval:
default: false
description: >-
Aprueba automáticamente la creación de sesiones secundarias (la
única comprobación que este indicador omite); cualquier comprobación
futura que se pueda omitir requiere un campo nuevo.
title: Bypass Approval
type: boolean
notifications:
anyOf:
- $ref: '#/components/schemas/AutomationSessionNotificationsConfig'
- type: 'null'
description: Notificaciones de contenido de sesión (actualmente solo Slack).
platform:
anyOf:
- type: string
- type: 'null'
description: >-
Plataforma de VM para la sesión. Cuando es null, la sesión usa la
plataforma predeterminada de la organización en el momento de la
invocación.
title: Platform
playbook_id:
anyOf:
- type: string
- type: 'null'
description: 'Solo lectura: derivado del primer token @playbook: en el prompt.'
title: Playbook Id
repos:
default: []
description: 'Solo lectura: derivado de los tokens de repositorio en el prompt.'
items:
type: string
title: Repos
type: array
tags:
default: []
description: >-
Etiquetas de sesión. Para empresas con etiquetado obligatorio, se
requiere exactamente un valor permitido.
items:
type: string
title: Tags
type: array
title: AutomationSessionConfig
type: object
AutomationConditions-Output:
additionalProperties: false
properties:
any:
description: OR de grupos AND (DNF fija de dos niveles).
items:
$ref: '#/components/schemas/AutomationConditionGroup'
title: Any
type: array
required:
- any
title: AutomationConditions
type: object
AutomationReply:
additionalProperties: false
properties:
type:
description: >-
notify_thread: aviso unidireccional de «sesión iniciada» en el hilo
desencadenante en el momento del envío (triggers de Slack).
attach_thread: asociación bidireccional con el hilo desencadenante
en el momento del envío (triggers de Slack). post_response: entrega
la respuesta del agente al contexto desencadenante.
enum:
- notify_thread
- attach_thread
- post_response
title: Type
type: string
required:
- type
title: AutomationReply
type: object
AutomationSessionNotificationsConfig:
additionalProperties: false
description: >-
Dónde se envía el contenido de la sesión creada, en lugar del
grupo ``notifications`` de nivel de automatización (avisos del estado de
despacho).
properties:
slack:
anyOf:
- $ref: '#/components/schemas/AutomationSessionSlackConfig'
- type: 'null'
description: >-
Da a la sesión un destino en Slack: two-way para
post_updates/forward_thread y post_response una vez que la entrega
inicial vincula el hilo.
title: AutomationSessionNotificationsConfig
type: object
AutomationConditionGroup:
additionalProperties: false
properties:
all:
description: 'AND: todas las condiciones del grupo deben cumplirse.'
items:
discriminator:
mapping:
between:
$ref: '#/components/schemas/AutomationRangeCondition'
contains:
$ref: '#/components/schemas/AutomationStringCondition'
ends_with:
$ref: '#/components/schemas/AutomationStringCondition'
eq:
$ref: '#/components/schemas/AutomationComparisonCondition'
globs:
$ref: '#/components/schemas/AutomationGlobCondition'
gt:
$ref: '#/components/schemas/AutomationNumericCondition'
gte:
$ref: '#/components/schemas/AutomationNumericCondition'
in:
$ref: '#/components/schemas/AutomationListCondition'
is_empty:
$ref: '#/components/schemas/AutomationEmptyCondition'
is_not_empty:
$ref: '#/components/schemas/AutomationEmptyCondition'
lt:
$ref: '#/components/schemas/AutomationNumericCondition'
lte:
$ref: '#/components/schemas/AutomationNumericCondition'
matches:
$ref: '#/components/schemas/AutomationMatchCondition'
neq:
$ref: '#/components/schemas/AutomationComparisonCondition'
not_contains:
$ref: '#/components/schemas/AutomationStringCondition'
not_ends_with:
$ref: '#/components/schemas/AutomationStringCondition'
not_globs:
$ref: '#/components/schemas/AutomationGlobCondition'
not_in:
$ref: '#/components/schemas/AutomationListCondition'
not_matches:
$ref: '#/components/schemas/AutomationMatchCondition'
not_starts_with:
$ref: '#/components/schemas/AutomationStringCondition'
recurrence:
$ref: '#/components/schemas/AutomationRecurrenceCondition'
starts_with:
$ref: '#/components/schemas/AutomationStringCondition'
propertyName: operator
oneOf:
- $ref: '#/components/schemas/AutomationComparisonCondition'
- $ref: '#/components/schemas/AutomationStringCondition'
- $ref: '#/components/schemas/AutomationNumericCondition'
- $ref: '#/components/schemas/AutomationEmptyCondition'
- $ref: '#/components/schemas/AutomationRangeCondition'
- $ref: '#/components/schemas/AutomationListCondition'
- $ref: '#/components/schemas/AutomationMatchCondition'
- $ref: '#/components/schemas/AutomationRecurrenceCondition'
- $ref: '#/components/schemas/AutomationGlobCondition'
title: All
type: array
required:
- all
title: AutomationConditionGroup
type: object
AutomationSessionSlackConfig:
additionalProperties: false
properties:
channel_id:
title: Channel Id
type: string
mode:
description: >-
post_updates: la sesión conversa en un hilo del canal (disponible
para activadores que no sean de Slack). forward_thread: lo mismo,
además de un enlace de retorno publicado en el hilo activador
(requiere un activador de Slack). post_response: la respuesta final
de la sesión se publica en el canal como mensaje de nivel superior;
luego su hilo se vincula para respuestas y mensajes de seguimiento
(disponible para cualquier activador).
enum:
- post_updates
- forward_thread
- post_response
title: Mode
type: string
required:
- mode
- channel_id
title: AutomationSessionSlackConfig
type: object
AutomationRangeCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
const: between
title: Operator
type: string
value:
description: Rango inclusivo [bajo, alto].
maxItems: 2
minItems: 2
prefixItems:
- anyOf:
- type: integer
- type: number
- anyOf:
- type: integer
- type: number
title: Value
type: array
required:
- field
- operator
- value
title: AutomationRangeCondition
type: object
AutomationStringCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- contains
- not_contains
- starts_with
- not_starts_with
- ends_with
- not_ends_with
title: Operator
type: string
value:
title: Value
type: string
required:
- field
- operator
- value
title: AutomationStringCondition
type: object
AutomationComparisonCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- eq
- neq
title: Operator
type: string
value:
anyOf:
- type: string
- type: integer
- type: number
- type: boolean
title: Value
required:
- field
- operator
- value
title: AutomationComparisonCondition
type: object
AutomationGlobCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- globs
- not_globs
title: Operator
type: string
value:
description: >-
Patrones glob; coincide cualquier ruta modificada (github:push,
gitlab:push).
items:
type: string
title: Value
type: array
required:
- field
- operator
- value
title: AutomationGlobCondition
type: object
AutomationNumericCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- gt
- lt
- gte
- lte
title: Operator
type: string
value:
anyOf:
- type: integer
- type: number
title: Value
required:
- field
- operator
- value
title: AutomationNumericCondition
type: object
AutomationListCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- in
- not_in
title: Operator
type: string
value:
items:
type: string
title: Value
type: array
required:
- field
- operator
- value
title: AutomationListCondition
type: object
AutomationEmptyCondition:
additionalProperties: false
description: >-
Operador unario: coincide con que el campo esté vacío; `value` no
contiene datos.
properties:
field:
title: Field
type: string
operator:
enum:
- is_empty
- is_not_empty
title: Operator
type: string
value:
title: Value
type: 'null'
required:
- field
- operator
title: AutomationEmptyCondition
type: object
AutomationMatchCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
enum:
- matches
- not_matches
title: Operator
type: string
value:
description: Expresión regular.
title: Value
type: string
required:
- field
- operator
- value
title: AutomationMatchCondition
type: object
AutomationRecurrenceCondition:
additionalProperties: false
properties:
field:
title: Field
type: string
operator:
const: recurrence
title: Operator
type: string
value:
description: >-
RRULE de iCalendar para el campo rrule de schedule:recurring, p.
ej., FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=0
title: Value
type: string
required:
- field
- operator
- value
title: AutomationRecurrenceCondition
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````