> ## 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.
# Obtenir les schémas d’événements d’automatisation
> Renvoie tous les schémas d’événements de déclencheur pris en charge, indexés par source puis par nom d’événement.
Chaque schéma décrit les champs de la charge utile de l’événement, les opérateurs pris en charge par
ses conditions et les verbes `replies` valides, afin que les appelants puissent
construire des `triggers` valides pour les endpoints de création et de mise à jour.
## Autorisations
Nécessite un utilisateur de service disposant de l’autorisation `ViewOrgAutomations` au niveau de l’organisation.
## Utilisation
Appelez cet endpoint avant de créer des automatisations : il renvoie tous les types d’événements déclencheurs pris en charge (classés par source, puis par nom d’événement), ainsi que leurs champs de charge utile, les opérateurs pris en charge par leurs conditions et les verbes `replies` valides, afin de vous permettre de construire des `triggers` valides pour les endpoints de création et de mise à jour. Les sources non activées pour l’organisation sont omises.
## OpenAPI
````yaml fr/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/schemas
openapi: 3.1.0
info:
description: API Devin v3 avec authentification par compte de service et RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/automations/schemas:
get:
tags:
- automations
summary: Obtenir les schémas d’événements d’automatisation
description: >-
Renvoie tous les schémas d’événements de déclencheur pris en charge,
indexés par source puis par nom d’événement.
Chaque schéma décrit les champs de la charge utile de l’événement, les
opérateurs pris en charge par
ses conditions et les verbes `replies` valides, afin que les appelants
puissent
construire des `triggers` valides pour les endpoints de création et de
mise à jour.
operationId: >-
handle_get_automation_schemas_v3_organizations__org_id__automations_schemas_get
parameters:
- description: "ID d’organisation (préfixe\_: 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: Réponse réussie
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorisé
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Interdit
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Introuvable
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflit
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenu non traitable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Trop de requêtes
components:
schemas:
AutomationSchemasResponse:
additionalProperties: false
properties:
sources:
additionalProperties:
additionalProperties:
$ref: '#/components/schemas/AutomationEventSchemaResponse'
type: object
description: Source d'événement → nom de l'événement → schéma.
title: Sources
type: object
update_semantics:
description: "Sémantique PATCH active pour cette organisation\_: «\_replace_groups\_» (un groupe de configuration présent dans la requête remplace intégralement le groupe enregistré) ou «\_merge_patch\_» (RFC 7396 pour les objets\_: les membres omis d'un groupe présent conservent leurs valeurs enregistrées, les valeurs null explicites les effacent\_; l'appartenance à une liste est toujours intégralement remplacée — pour supprimer un élément, renvoyez la liste sans cet élément — mais chaque élément envoyé est fusionné avec l'élément enregistré du même type lorsque ce type apparaît exactement une fois de chaque côté\_; les types répétés doivent être réindiqués dans leur intégralité). Énumération ouverte\_: les clients doivent tolérer de nouvelles valeurs."
title: Update Semantics
type: string
required:
- update_semantics
- sources
title: AutomationSchemasResponse
type: object
ProblemDetail:
description: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explication en langage clair, spécifique à cette occurrence.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erreurs de validation par champ (réponses 422 uniquement).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
title: Instance
status:
description: Le code d’état HTTP.
title: Status
type: integer
title:
description: Un bref résumé du type de problème, compréhensible par un humain.
title: Title
type: string
type:
default: about:blank
description: Une référence d’URI identifiant le type de problème.
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: >-
Chemin du champ de condition → définition du champ (type, libellé,
obligatoire, options, ...).
title: Fields
type: object
name:
title: Name
type: string
supported_replies:
description: Verbes replies[].type valides pour ce type d’événement.
items:
type: string
title: Supported Replies
type: array
required:
- event_type
- name
- category
- supported_replies
- fields
title: AutomationEventSchemaResponse
type: object
AutomationSchemaFieldDef:
additionalProperties: false
description: >-
Vue aplatie d'une définition de champ de condition.
Les attributs spécifiques au type (``options``,
``min``/``max``/``unit``,
``granularity``, ``placeholder``) ne sont renseignés que pour le
``type`` concerné.
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: "Identifiant de compte de service (préfixe\_: cog_)"
scheme: bearer
type: http
````