> ## 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.
# Recupera gli schemi degli eventi di automazione
> Restituisce tutti gli schemi degli eventi trigger supportati, organizzati per sorgente e poi per nome dell'evento.
Ogni schema descrive i campi del payload dell'evento, gli operatori supportati dalle relative
condizioni e i verbi `replies` validi, consentendo ai chiamanti di
creare `triggers` validi per gli endpoint di creazione e aggiornamento.
## Autorizzazioni
Richiede un utente di servizio con l'autorizzazione `ViewOrgAutomations` a livello dell'organizzazione.
## Utilizzo
Chiama questo endpoint prima di creare automazioni: restituisce tutti i tipi di eventi trigger supportati (raggruppati prima per sorgente, poi per nome dell'evento), con i relativi campi payload, gli operatori supportati dalle condizioni e i verbi `replies` validi. In questo modo puoi costruire `triggers` validi per gli endpoint di creazione e aggiornamento. Le sorgenti non abilitate per l'organizzazione vengono omesse.
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/schemas
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/schemas:
get:
tags:
- automations
summary: Recupera gli schemi degli eventi di automazione
description: >-
Restituisce tutti gli schemi degli eventi trigger supportati,
organizzati per sorgente e poi per nome dell'evento.
Ogni schema descrive i campi del payload dell'evento, gli operatori
supportati dalle relative
condizioni e i verbi `replies` validi, consentendo ai chiamanti di
creare `triggers` validi per gli endpoint di creazione e aggiornamento.
operationId: >-
handle_get_automation_schemas_v3_organizations__org_id__automations_schemas_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/AutomationSchemasResponse'
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:
AutomationSchemasResponse:
additionalProperties: false
properties:
sources:
additionalProperties:
additionalProperties:
$ref: '#/components/schemas/AutomationEventSchemaResponse'
type: object
description: Sorgente dell'evento → nome dell'evento → schema.
title: Sources
type: object
update_semantics:
description: >-
Semantica PATCH attiva per questa organizzazione: 'replace_groups'
(un gruppo di configurazione presente nella richiesta sostituisce
interamente il gruppo memorizzato) o 'merge_patch' (RFC 7396 per gli
oggetti: i membri omessi di un gruppo presente mantengono i valori
memorizzati, i valori null espliciti cancellano; l'appartenenza a
una lista viene comunque sostituita interamente — per eliminare un
elemento, reinviare la lista senza quell'elemento — ma ogni elemento
inviato viene unito all'elemento memorizzato dello stesso tipo
quando tale tipo compare esattamente una volta su entrambi i lati; i
tipi ripetuti devono essere ridefiniti completamente). Enum aperta:
i client devono tollerare nuovi valori.
title: Update Semantics
type: string
required:
- update_semantics
- sources
title: AutomationSchemasResponse
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
AutomationEventSchemaResponse:
additionalProperties: false
properties:
category:
title: Category
type: string
event_type:
title: Event Type
type: string
fields:
additionalProperties:
$ref: '#/components/schemas/AutomationSchemaFieldDef'
description: >-
Percorso del campo della condizione → definizione del campo (tipo,
etichetta, obbligatorio, opzioni, ...).
title: Fields
type: object
name:
title: Name
type: string
supported_replies:
description: Verbi replies[].type validi per questo tipo di 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 piatta di una definizione di campo condizionale.
Gli attributi specifici del tipo (``options``, ``min``/``max``/``unit``,
``granularity``, ``placeholder``) vengono popolati solo per il relativo
``type``.
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: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````