> ## 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.
# Ereignisschemas für Automatisierungen abrufen
> Alle unterstützten Trigger-Ereignisschemas zurückgeben, nach Quelle und anschließend nach Ereignisname gruppiert.
Jedes Schema beschreibt die Nutzlastfelder des Ereignisses, die von seinen
Bedingungen unterstützten Operatoren und die gültigen `replies`-Verben, damit Aufrufer gültige
`triggers` für die Erstell- und Aktualisierungsendpunkte erstellen können.
## Berechtigungen
Erfordert einen Service-Benutzer mit der Berechtigung `ViewOrgAutomations` auf Organisationsebene.
## Verwendung
Rufen Sie diesen Endpunkt auf, bevor Sie Automatisierungen erstellen: Er gibt alle unterstützten Trigger-Ereignistypen (nach Quelle und anschließend nach Ereignisname gruppiert) mit ihren Payload-Feldern, den von ihren Bedingungen unterstützten Operatoren und den gültigen `replies`-Verben zurück. So können Sie gültige `triggers` für die Endpunkte zum Erstellen und Aktualisieren erstellen. Quellen, die für die Organization nicht aktiviert sind, werden nicht berücksichtigt.
## OpenAPI
````yaml de/v3-openapi.yaml GET /v3/organizations/{org_id}/automations/schemas
openapi: 3.1.0
info:
description: Devin v3 API mit Service-User-Authentifizierung und RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/automations/schemas:
get:
tags:
- automations
summary: Ereignisschemas für Automatisierungen abrufen
description: >-
Alle unterstützten Trigger-Ereignisschemas zurückgeben, nach Quelle und
anschließend nach Ereignisname gruppiert.
Jedes Schema beschreibt die Nutzlastfelder des Ereignisses, die von
seinen
Bedingungen unterstützten Operatoren und die gültigen `replies`-Verben,
damit Aufrufer gültige
`triggers` für die Erstell- und Aktualisierungsendpunkte erstellen
können.
operationId: >-
handle_get_automation_schemas_v3_organizations__org_id__automations_schemas_get
parameters:
- description: 'Organisations-ID (Präfix: 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: Erfolgreiche Antwort
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht autorisiert
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Zugriff verweigert
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht gefunden
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Konflikt
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht verarbeitbarer Inhalt
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Zu viele Anfragen
components:
schemas:
AutomationSchemasResponse:
additionalProperties: false
properties:
sources:
additionalProperties:
additionalProperties:
$ref: '#/components/schemas/AutomationEventSchemaResponse'
type: object
description: Ereignisquelle → Ereignisname → Schema.
title: Sources
type: object
update_semantics:
description: >-
Für diese Organisation aktive PATCH-Semantik: 'replace_groups' (eine
in der Anfrage enthaltene Konfigurationsgruppe ersetzt die
gespeicherte Gruppe vollständig) oder 'merge_patch' (RFC 7396 für
Objekte: Nicht angegebene Mitglieder einer vorhandenen Gruppe
behalten ihre gespeicherten Werte, explizite null-Werte löschen sie;
die Listenmitgliedschaft wird weiterhin vollständig ersetzt – zum
Löschen wird die Liste ohne das Element erneut gesendet –, aber
jedes gesendete Element wird mit dem gespeicherten Element desselben
Typs zusammengeführt, wenn dieser Typ auf beiden Seiten genau einmal
vorkommt; wiederholte Typen müssen vollständig erneut angegeben
werden). Offenes Enum – Clients müssen neue Werte tolerieren.
title: Update Semantics
type: string
required:
- update_semantics
- sources
title: AutomationSchemasResponse
type: object
ProblemDetail:
description: >-
RFC 9457 application/problem+json-Fehlertext für die v3-API.
detail wird aus dem Legacy-Body {"detail": ...} aus Gründen der
Abwärtskompatibilität beibehalten; die
anderen Member sind additiv. errors enthält Validierungsfehler auf
Feldebene
(nur 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Eine menschenlesbare Erklärung, die speziell für diesen Fall gilt.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Validierungsfehler auf Feldebene (nur bei 422-Antworten).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Eine URI-Referenz (der Anfragepfad) für diesen Fall.
title: Instance
status:
description: Der HTTP-Statuscode.
title: Status
type: integer
title:
description: Eine kurze, menschenlesbare Zusammenfassung des Problemtyps.
title: Title
type: string
type:
default: about:blank
description: Eine URI-Referenz, die den Problemtyp identifiziert.
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: >-
Pfad des Bedingungsfelds → Felddefinition (Typ, Label, erforderlich,
Optionen, ...).
title: Fields
type: object
name:
title: Name
type: string
supported_replies:
description: Gültige Verben für replies[].type bei diesem Ereignistyp.
items:
type: string
title: Supported Replies
type: array
required:
- event_type
- name
- category
- supported_replies
- fields
title: AutomationEventSchemaResponse
type: object
AutomationSchemaFieldDef:
additionalProperties: false
description: |-
Flache Ansicht einer Bedingungsfelddefinition.
Typspezifische Attribute (``options``, ``min``/``max``/``unit``,
``granularity``, ``placeholder``) werden nur für den jeweiligen
``type`` ausgefüllt.
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: 'Servicebenutzer-Anmeldedaten (Präfix: cog_)'
scheme: bearer
type: http
````