> ## 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.
# Elenca i template di automazione
> Elenca i template di automazione integrati.
I valori di `template_id` sono accettati dall'endpoint di creazione; se
`tools.mcp_servers` viene omesso durante la creazione, si applicano i
`required_mcps` del template.
## Autorizzazioni
Richiede un utente di servizio con l'autorizzazione `ViewOrgAutomations` a livello di organizzazione.
## Utilizzo
Elenca i modelli di automazione predefiniti. I valori di `template_id` sono accettati dall'endpoint create come indicatore di provenienza; se `tools.mcp_servers` viene omesso durante la creazione, si applicano i `required_mcps` del modello.
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/templates
openapi: 3.1.0
info:
description: API Devin v3 con autenticazione utente di servizio e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/automations/templates:
get:
tags:
- automations
summary: Elenca i template di automazione
description: |-
Elenca i template di automazione integrati.
I valori di `template_id` sono accettati dall'endpoint di creazione; se
`tools.mcp_servers` viene omesso durante la creazione, si applicano i
`required_mcps` del template.
operationId: >-
handle_list_automation_templates_v3_organizations__org_id__automations_templates_get
parameters:
- description: 'ID dell''organizzazione (prefisso: 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: Risposta riuscita
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorizzato
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Vietato
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non trovato
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflitto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenuto non elaborabile
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Troppe richieste
components:
schemas:
AutomationTemplatesResponse:
additionalProperties: false
properties:
templates:
items:
$ref: '#/components/schemas/AutomationTemplateResponse'
title: Templates
type: array
required:
- templates
title: AutomationTemplatesResponse
type: object
ProblemDetail:
description: >-
Corpo dell'errore application/problem+json RFC 9457 per l'API v3.
detail è mantenuto dal corpo legacy {"detail": ...} per
retrocompatibilità; gli
altri membri sono aggiuntivi. errors contiene gli errori di validazione
a livello di campo
(solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: >-
Una spiegazione leggibile dall'utente, specifica per questa
occorrenza.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errori di convalida a livello di campo (solo per le risposte 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: >-
Un riferimento URI (il percorso della richiesta) per questa
occorrenza.
title: Instance
status:
description: Il codice di stato HTTP.
title: Status
type: integer
title:
description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
title: Title
type: string
type:
default: about:blank
description: Un riferimento URI che identifica il tipo di 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: >-
Se true, il primo trigger crea una nuova sessione a lunga esecuzione
di proprietà dell'automazione e i trigger successivi le inviano
messaggi.
title: Auto Create
type: boolean
prompt:
description: Il payload dell'evento attivante viene aggiunto automaticamente.
title: Prompt
type: string
target_devin_id:
anyOf:
- type: string
- type: 'null'
description: >-
Deve appartenere all'org; la modifica di un'automazione contenente
questa action richiede accesso in scrittura alla sessione di
destinazione (sono escluse le modifiche di sola
abilitazione/disabilitazione). Obbligatorio a meno che auto_create
non sia true, nel qual caso viene impostato lato server quando il
primo trigger crea la sessione; i valori forniti dal client vengono
ignorati.
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: >-
Inserito nel prompt di sistema della sessione. Usa la stessa
grammatica dei token di riferimento di prompt.
title: Setup Prompt
type: string
slack_monitor_config:
$ref: '#/components/schemas/AutomationSlackMonitorConfig'
description: Richiede esattamente un trigger slack:message sullo stesso canale.
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: >-
L'unica fonte di verità: testo semplice con token di riferimento
inline (@{owner}/{repo}, @{path}, @playbook:{id}, @skills:{name},
!{macro}, ${SECRET_NAME}). I token con prefisso del tipo vengono
convalidati al salvataggio; gli ID sconosciuti restituiscono un
errore 400. Il payload dell'evento attivante viene aggiunto
automaticamente.
title: Prompt
type: string
session:
$ref: '#/components/schemas/AutomationSessionConfig-Output'
description: Configurazione per la sessione generata.
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 corrisponde a ogni evento.
event_type:
description: Tipo di evento del trigger, ad es. '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: >-
Dove viene associata la sessione di questo trigger e dove viene
recapitata la relativa risposta. Vengono eseguite solo le risposte
del trigger corrispondente; tutte le voci operano in modo
indipendente e vengono deduplicate.
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: >-
Approva automaticamente la creazione di sessioni figlie (l'unico
controllo aggirato da questo flag); qualsiasi futuro controllo
aggirabile richiede un nuovo campo.
title: Bypass Approval
type: boolean
notifications:
anyOf:
- $ref: '#/components/schemas/AutomationSessionNotificationsConfig'
- type: 'null'
description: Notifiche sul contenuto delle sessioni (attualmente solo Slack).
platform:
anyOf:
- type: string
- type: 'null'
description: >-
Piattaforma VM per la sessione. Se null, la sessione usa la
piattaforma predefinita dell'organizzazione al momento
dell'invocazione.
title: Platform
playbook_id:
anyOf:
- type: string
- type: 'null'
description: 'Sola lettura: derivato dal primo token @playbook: nel prompt.'
title: Playbook Id
repos:
default: []
description: 'Sola lettura: derivato dai token repo nel prompt.'
items:
type: string
title: Repos
type: array
tags:
default: []
description: >-
Tag di sessione. Per le enterprise con applicazione obbligatoria dei
tag è richiesto esattamente un valore consentito.
items:
type: string
title: Tags
type: array
title: AutomationSessionConfig
type: object
AutomationConditions-Output:
additionalProperties: false
properties:
any:
description: OR di gruppi AND (DNF fissa a due livelli).
items:
$ref: '#/components/schemas/AutomationConditionGroup'
title: Any
type: array
required:
- any
title: AutomationConditions
type: object
AutomationReply:
additionalProperties: false
properties:
type:
description: >-
notify_thread: indicatore unidirezionale di 'sessione avviata' nel
thread attivante al momento dell'invio (trigger Slack).
attach_thread: associazione bidirezionale al thread attivante al
momento dell'invio (trigger Slack). post_response: invia la risposta
dell'agente al contesto attivante.
enum:
- notify_thread
- attach_thread
- post_response
title: Type
type: string
required:
- type
title: AutomationReply
type: object
AutomationSessionNotificationsConfig:
additionalProperties: false
description: >-
Dove viene inviato il contenuto della sessione generata, anziché nel
gruppo
``notifications`` a livello di automazione (notifiche sullo stato di
invio).
properties:
slack:
anyOf:
- $ref: '#/components/schemas/AutomationSessionSlackConfig'
- type: 'null'
description: >-
Assegna alla sessione un punto di riferimento su Slack: interazione
bidirezionale per post_updates/forward_thread e post_response dopo
che la consegna iniziale ha associato il thread.
title: AutomationSessionNotificationsConfig
type: object
AutomationConditionGroup:
additionalProperties: false
properties:
all:
description: 'AND: tutte le condizioni nel gruppo devono corrispondere.'
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 sessione conversa in un thread nel canale
(disponibile per trigger non Slack). forward_thread: come sopra, più
un collegamento inverso pubblicato nel thread che ha attivato
l'azione (richiede un trigger Slack). post_response: la risposta
finale della sessione viene pubblicata nel canale come messaggio di
primo livello, quindi il relativo thread viene associato per
risposte e messaggi successivi (disponibile per qualsiasi trigger).
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: Intervallo inclusivo [minimo, massimo].
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: >-
Pattern glob; corrisponde a qualsiasi percorso modificato
(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: >-
Operatore unario: verifica se il campo è vuoto; `value` non contiene
dati.
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: Espressione regolare.
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 iCalendar per il campo rrule di schedule:recurring, ad es.
FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=0
title: Value
type: string
required:
- field
- operator
- value
title: AutomationRecurrenceCondition
type: object
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````