> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow aktualisieren API: KYC-Flow bearbeiten

> Didit KYC- oder KYB-Workflow per API aktualisieren: umbenennen, Funktionen ersetzen, Schwellenwerte anpassen. Pro Aufruf, ohne Verträge.



Workflow per API aktualisieren
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\`Update a simple Didit workflow through the Management API.

Endpoint:
PATCH https://verification.didit.me/v3/workflows/{settings_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.

Requirements:
\- Use PATCH and include only the fields I want to change.
\- To rename the workflow, send workflow_label only.
\- To change workflow checks, send the full desired features array. This replaces the previous feature order and config.
\- Do not send workflow_graph, branches, actions, webhooks, or conditional logic.
\- Send features in the exact execution order.
\- Use uppercase feature values such as OCR, LIVENESS, FACE_MATCH, AML, QUESTIONNAIRE, EMAIL_VERIFICATION, PHONE_VERIFICATION, or PROOF_OF_ADDRESS.
\- Configure each feature with the fields from /management-api/workflows/feature-configs.
\- For an OCR feature, omit config.documents_allowed or send an empty object to allow every supported document type. Send config.documents_allowed only to restrict the allowed documents.
\- Keep dependency order valid. For example, put OCR before FACE_MATCH.
\- If the workflow includes QUESTIONNAIRE, use the latest questionnaire_id as config.questionnaire_uuid.

Example metadata update body:
\{
"workflow_label": "Premium KYC"
}

Example full feature replacement body:
\{
"features": [
\{
  "feature": "OCR",
  "config": {
    "documents_allowed": {
      "USA": {
        "DL": {
          "enabled": 1,
          "sides": 2
        }
      }
    }
  }
},
\{
  "feature": "AML",
  "config": {
    "aml_score_review_threshold": 70,
    "aml_score_approve_threshold": 30
  }
}
]
}

Build the API call, handle validation errors, and return the updated workflow response.`

\</pre>



      
      

Einfügen in

Verwenden Sie `PATCH` für partielle Aktualisierungen. Um einen Workflow umzubenennen, senden Sie nur `workflow_label`.```json theme={null}
{
  "workflow_label": "Premium KYC"
}
```Um die Prüfungen im Workflow zu ändern, senden Sie das vollständige gewünschte `features`-Array. Dadurch werden die bisherige Reihenfolge der Funktionen und deren Konfiguration ersetzt.```json theme={null}
{
  "features": [
    {
      "feature": "OCR",
      "config": {
        "documents_allowed": {
          "USA": {
            "DL": {
              "enabled": 1,
              "sides": 2
            }
          }
        }
      }
    },
    {
      "feature": "AML",
      "config": {
        "aml_score_review_threshold": 70,
        "aml_score_approve_threshold": 30
      }
    }
  ]
}
```Die v3-API hält Workflows einfach: einen linearen Pfad und einen abschließenden Statusschritt. Verzweigungen, Aktionsknoten und Webhook-Knoten werden hier nicht akzeptiert.## Referenz der FunktionskonfigurationWenn Sie `features` in einem `PATCH` senden, ersetzt das Array die bisherige Reihenfolge der Funktionen und deren Konfiguration. Geben Sie jede erforderliche Konfiguration erneut an.Das genaue `config`-Objekt hängt von der Funktion ab. Die vollständige Feldliste, Standardwerte, erforderlichen Einstellungen, Wertebereiche und Beispiele finden Sie unter [Konfigurationen der Workflow-Funktionen](https://docs.didit.me/de/management-api/workflows/feature-configs.md).Für `OCR` lassen Sie `config.documents_allowed` weg, senden `null` oder senden `{}`, um alle unterstützten Dokumenttypen zuzulassen. Geben Sie es nur an, wenn Sie den Workflow auf bestimmte Länder oder Dokumenttypen beschränken möchten. Für `QUESTIONNAIRE` ist `config.questionnaire_uuid` erforderlich.## Workflow-Einstellungen aktualisierenSie können sitzungsbezogene Einstellungen aktualisieren, ohne die Funktionsliste zu ändern. Senden Sie nur die Felder, die Sie ändern möchten.| Feld | Typ | Beschreibung |
| - | - | - |
| `is_white_label_enabled` | Boolean | Aktiviert die White-Label-Anpassung für Sitzungen, die mit diesem Workflow erstellt werden. |
| `is_desktop_allowed` | Boolean | Erlaubt, dass der Verifizierungsablauf in Desktop-Browsern ausgeführt wird. |
| `max_retry_attempts` | Ganzzahl (0–10) | Maximale Anzahl an Wiederholungsversuchen nach einer abgelehnten Verifizierung. `0` sperrt den Benutzer nach der ersten Ablehnung. |
| `retry_window_days` | Ganzzahl (1–365) oder `null` | Gleitendes Zeitfenster in Tagen, das zum Zählen der Wiederholungsversuche verwendet wird (`null` = Limit ohne zeitliche Begrenzung). |
| `session_expiration_time` | Ganzzahl (3600–2419200) | Sekunden, bis eine nicht abgeschlossene Sitzung abläuft. Mindestens 1 Stunde, höchstens 4 Wochen. |```json theme={null}
{
  "is_white_label_enabled": true,
  "is_desktop_allowed": true,
  "max_retry_attempts": 5,
  "retry_window_days": 14,
  "session_expiration_time": 86400
}
```Verwenden Sie die `uuid` des Workflows, die der Listen-, Erstellungs- oder Abruf-Endpoint zurückgibt, als `settings_uuid` in dieser URL.


## OpenAPI

````yaml de/openapi-25.json PATCH /v3/workflows/{settings_uuid}/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/workflows/{settings_uuid}/:
    patch:
      tags:
        - Workflows
      summary: Workflow aktualisieren
      description: >-
        Workflow aktualisieren. Die Versionierung hängt vom übergebenen
        `status`-Feld und dem aktuellen Status der Version ab: (1) kein `status`
        bei einer **veröffentlichten** Version → die veröffentlichte Version
        wird direkt aktualisiert (gleiche `uuid`, gleiche `version`); (2) kein
        `status` bei einem **Entwurf** → der Entwurf wird aktualisiert und
        sofort veröffentlicht; (3) `status: "published"` bei einer
        **veröffentlichten** Version → eine NEUE veröffentlichte Version wird
        unter derselben `workflow_id` erstellt (neue `uuid`, `version` + 1) und
        zurückgegeben, und jeder vorhandene Entwurf in der Gruppe wird gelöscht;
        (4) `status: "draft"` belässt einen Entwurf als Entwurf (automatische
        Speicherung), wird jedoch bei einer veröffentlichten Version mit 400
        abgelehnt (`"Cannot revert a published version to draft."`). Der Body
        akzeptiert dieselbe strikte Positivliste für Felder wie beim Erstellen –
        unbekannte Schlüssel werden mit 400 abgelehnt.
      operationId: update_workflow
      parameters:
        - name: settings_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Versionsspezifische UUID des zu aktualisierenden Workflows.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SimpleWorkflowUpdateRequest'
            examples:
              Replace features:
                summary: Vollständige gewünschte Funktionsreihenfolge senden
                value:
                  features:
                    - feature: OCR
                    - feature: AML
              Rename:
                summary: Workflow umbenennen
                value:
                  workflow_label: Premium KYC
              Set as default:
                summary: Diesen Workflow als Standard der Anwendung festlegen
                value:
                  is_default: true
              Update config:
                summary: Funktionskonfiguration ändern
                value:
                  features:
                    - feature: OCR
                    - feature: LIVENESS
                      config:
                        face_liveness_method: passive
              Publish a draft:
                summary: Einen Entwurf in den Status „veröffentlicht“ überführen
                value:
                  status: published
      responses:
        '200':
          description: >-
            Workflow aktualisiert. Der Body ist die VOLLSTÄNDIGE Konfiguration
            der resultierenden Version (dieselbe Rohform von
            `VerificationSettings` wie bei `GET
            /v3/workflows/{settings_uuid}/`). Wenn die Aktualisierung eine neue
            Version erstellt hat (`status: "published"` bei einer
            veröffentlichten Zeile gesendet), weichen die zurückgegebenen Werte
            für `uuid` und `version` von denen ab, die Sie gepatcht haben —
            verwenden Sie die zurückgegebene `uuid` für nachfolgende Aufrufe.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowDetail'
        '400':
          description: >-
            Validierungsfehler – ein Top-Level-Schlüssel außerhalb der
            akzeptierten Whitelist, eine unbekannte Funktion, eine ungültige
            Reihenfolge, ein Schwellenwert außerhalb des Bereichs, Verweis auf
            einen nicht existierenden Fragebogen, eine `SIGNATURE`-Funktion, die
            ohne zu signierendes Dokument live gehen würde, eine neue
            `SIGNATURE`-Funktion mit `signature_level: "aes"`, während Advanced
            (AES) nicht verfügbar ist (`aes_not_available`, siehe
            `signature_availability` im Workflow; ein Schritt, der `aes` bereits
            speichert, behält es) oder `status: "draft"` für eine
            veröffentlichte Version gesendet (`"Cannot revert a published
            version to draft."`). Der Antwort-Body ist ein
            DRF-Validierungsfehler mit dem Feldnamen als Schlüssel.
        '403':
          description: API-Schlüssel fehlt oder ist ungültig.
          content:
            application/json:
              examples:
                Invalid token:
                  value:
                    detail: You do not have permission to perform this action.
        '404':
          description: >-
            Für die authentifizierte Anwendung existiert kein Workflow mit
            dieser `settings_uuid`.
        '415':
          description: >-
            Nicht unterstützter Medientyp. Setzen Sie `Content-Type:
            application/json`.
        '429':
          description: >-
            Rate-Limit überschritten. Wiederholen Sie die Anfrage mit
            exponentiellem Backoff.
        '500':
          description: Unerwarteter Serverfehler. Kann sicher wiederholt werden.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: >-
            curl -X PATCH
            'https://verification.didit.me/v3/workflows/a1b2c3d4-5678-90ab-cdef-111111111111/'
            \
              -H 'x-api-key: YOUR_API_KEY' \
              -H 'Content-Type: application/json' \
              -d '{"workflow_label": "Premium KYC"}'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.workflows.update(
                "11111111-2222-3333-4444-555555555555",
                features=[{
                    "feature": "OCR",
                }, {
                    "feature": "AML",
                }],
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.workflows.update("11111111-2222-3333-4444-555555555555", {
              features: [{
                feature: "OCR",
              }, {
                feature: "AML",
              }],
            });

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Workflows.Update(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SimpleWorkflowUpdateRequest{\n\tFeatures: didit.Some([]didit.SimpleWorkflowFeature{{\n\t\tFeature: \"OCR\",\n\t}, {\n\t\tFeature: \"AML\",\n\t}}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import java.util.List;

            import me.didit.Didit;

            import me.didit.types.SimpleWorkflowFeature;

            import me.didit.types.SimpleWorkflowUpdateRequest;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.workflows().update("11111111-2222-3333-4444-555555555555",
            SimpleWorkflowUpdateRequest.builder()
                    .features(List.of(
                            SimpleWorkflowFeature.builder()
                                    .feature(SimpleWorkflowFeature.Feature.of("OCR"))
                                    .build(),
                            SimpleWorkflowFeature.builder()
                                    .feature(SimpleWorkflowFeature.Feature.of("AML"))
                                    .build()))
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->workflows->update('11111111-2222-3333-4444-555555555555', [
                'features' => [[
                    'feature' => 'OCR',
                ], [
                    'feature' => 'AML',
                ]],
            ]);

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.workflows.update(
              "11111111-2222-3333-4444-555555555555",
              features: [{
                feature: "OCR",
              }, {
                feature: "AML",
              }]
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Workflows.UpdateAsync("11111111-2222-3333-4444-555555555555",
            new SimpleWorkflowUpdateRequest

            {
                Features = new SimpleWorkflowFeature[]
                {
                    new()
                    {
                        Feature = "OCR",
                    },
                    new()
                    {
                        Feature = "AML",
                    },
                },
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    SimpleWorkflowUpdateRequest:
      type: object
      description: >-
        Workflow-Metadaten aktualisieren oder die gesamte lineare Liste der
        Funktionen ersetzen. STRIKTE Feld-Whitelist: Jeder hier nicht
        aufgeführte Schlüssel wird mit 400 abgewiesen.
      properties:
        workflow_label:
          type: string
          maxLength: 50
          description: Anzeigename für den Workflow (max. 50 Zeichen).
        is_default:
          type: boolean
          description: Legen Sie diesen Workflow als Standard für neue Sitzungen fest.
        status:
          type: string
          enum:
            - draft
            - published
          description: >-
            Steuert die Versionierung. Weglassen, um die aktuelle Version direkt
            zu aktualisieren (Entwürfe werden automatisch veröffentlicht).
            `published` bei einer bereits veröffentlichten Version erstellt und
            gibt eine NEUE Version zurück. `draft` ist nur gültig, solange die
            Version noch ein Entwurf ist.
        features:
          type: array
          minItems: 1
          description: >-
            Falls angegeben, ersetzt dies die vollständige Funktionsreihenfolge
            und -konfiguration.
          items:
            $ref: '#/components/schemas/SimpleWorkflowFeature'
        is_white_label_enabled:
          type: boolean
          description: >-
            White-Label-Anpassung für Sitzungen aktivieren, die mit diesem
            Workflow erstellt wurden.
        is_desktop_allowed:
          type: boolean
          description: >-
            Ermöglicht die Ausführung des Verifizierungs-Workflows in
            Desktop-Browsern.
        max_retry_attempts:
          type: integer
          minimum: 0
          maximum: 10
          description: >-
            Maximale Anzahl an Wiederholungsversuchen, die nach einer
            abgelehnten Verifizierung zulässig sind. `0` blockiert den Benutzer
            nach der ersten Ablehnung.
        retry_window_days:
          type: integer
          minimum: 1
          maximum: 365
          nullable: true
          description: >-
            Gleitendes Zeitfenster in Tagen zur Zählung der
            Wiederholungsversuche. `null` erzwingt ein Limit für den gesamten
            Zeitraum.
        face_liveness_max_attempts:
          type: integer
          minimum: 1
          maximum: 3
          description: >-
            Maximale Anzahl an Liveness-Übermittlungen pro Sitzung. Dieser Wert
            wird auch in generierte Liveness- und
            Altersschätzungs-Workflow-Knoten kopiert, sofern er nicht durch die
            Konfiguration auf Funktionsebene überschrieben wird.
        face_match_max_attempts:
          type: integer
          minimum: 1
          maximum: 3
          description: >-
            Maximale Anzahl an Gesichtsabgleich-Übermittlungen pro Sitzung.
            Dieser Wert wird auch in generierte Gesichtsabgleich-Workflow-Knoten
            kopiert, sofern er nicht durch die Konfiguration auf Funktionsebene
            überschrieben wird.
        session_expiration_time:
          type: integer
          minimum: 3600
          maximum: 2419200
          description: >-
            Sekunden, bis eine nicht abgeschlossene Sitzung abläuft. Mindestens
            1 Stunde (3600), maximal 4 Wochen (2419200).
    WorkflowDetail:
      type: object
      description: >-
        Die folgenden Felder sind typisiert; das Objekt enthält außerdem jede
        andere Spalte der Workflow-Konfiguration (Funktionsschalter,
        Schwellenwerte, Warnungsaktionen, zulässige Dokumente, Callbacks) als
        zusätzliche Eigenschaften. Felder, die für den `workflow_type` nicht
        gelten, sind `null`.
      properties:
        uuid:
          type: string
          format: uuid
          description: >-
            Versionsspezifische Kennung (`settings_uuid`). Jede Version eines
            Workflows hat ihre eigene.
        workflow_id:
          type: string
          format: uuid
          description: >-
            Stabiler Identifikator, der von jeder Version des Workflows geteilt
            wird. Damit erstellte Sitzungen verwenden die neueste
            veröffentlichte Version.
        workflow_label:
          type: string
          description: Anzeigename des Workflows.
        workflow_type:
          type: string
          nullable: true
          enum:
            - kyc
            - kyb
            - adaptive_age_verification
            - biometric_authentication
            - address_verification
            - questionnaire_verification
            - email_verification
            - phone_verification
            - null
          description: >-
            Workflow-Vorlage. `null` für Graph-Workflows, die ohne Vorlage
            erstellt wurden.
        is_default:
          type: boolean
          description: Gibt an, ob dies der Standard-Workflow der Anwendung ist.
        is_archived:
          type: boolean
          description: Archivierte Workflows können keine neuen Sitzungen starten.
        version:
          type: integer
          description: Versionsnummer innerhalb des Workflows.
        status:
          type: string
          enum:
            - draft
            - published
          description: >-
            Entwurfsversionen können bearbeitet werden; veröffentlichte
            Versionen sind unveränderlich und werden für neue Sitzungen
            verwendet.
        published_at:
          type: string
          format: date-time
          nullable: true
          description: Wann diese Version veröffentlicht wurde. `null` für Entwürfe.
        is_simple_workflow:
          type: boolean
          description: >-
            `true`, wenn der Workflow keinen benutzerdefinierten
            `workflow_graph` hat.
        is_editable:
          type: boolean
          description: '`true` nur für `draft`-Versionen.'
        workflow_url:
          type: string
          format: uri
          description: Öffentliche URL, die eine Sitzung mit diesem Workflow startet.
        workflow_graph:
          type: object
          nullable: true
          additionalProperties: true
          description: >-
            Graphstruktur des Workflows (Knoten und Kanten). `null` für einfache
            Workflows.
        features:
          type: string
          description: >-
            Aktivierte Funktionen, verbunden mit `" + "`, zum Beispiel `"OCR +
            LIVENESS"`.
        total_price:
          type: number
          nullable: true
          description: Preis pro Sitzung; bei Graph-Workflows der teuerste Pfad.
        min_price:
          type: number
          nullable: true
          description: Preis des günstigsten Pfads durch den Workflow.
        max_price:
          type: number
          nullable: true
          description: Preis des teuersten Pfads durch den Workflow.
        special_add_on_prices:
          type: object
          nullable: true
          additionalProperties: true
          description: >-
            Organisationsspezifische Zusatzpreise oder `null`, wenn keine
            festgelegt sind.
        max_retry_attempts:
          type: integer
          description: >-
            Zulässige Wiederholungsversuche nach einer abgelehnten
            Verifizierung.
        retry_window_days:
          type: integer
          nullable: true
          description: Tage, während derer Wiederholungsversuche zulässig sind.
        session_expiration_time:
          type: integer
          description: Sekunden, bis eine nicht abgeschlossene Sitzung abläuft.
        questionnaire:
          type: object
          nullable: true
          additionalProperties: true
          description: Der an den Workflow angehängte Fragebogen oder `null`.
        kyb_role_settings:
          type: array
          items:
            type: object
            additionalProperties: true
          description: Verifizierungseinstellungen pro Rolle für KYB-Schlüsselpersonen.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        signature_availability:
          type: object
          description: >-
            Welche E-Signatur-Stufen derzeit signieren können. Prüfen Sie dies,
            bevor Sie `signature_level` festlegen. Wird bei `kyc`-, `kyb`- und
            Graph-Workflows zurückgegeben.
          properties:
            simple:
              type: boolean
              description: Simple ist immer verfügbar.
            aes:
              type: boolean
              description: >-
                Gibt an, ob Advanced (AES) jetzt signieren kann. Solange dies
                `false` ist, wird das Speichern eines neuen Schritts mit
                `signature_level: "aes"` mit `aes_not_available` abgelehnt.
            qes:
              type: boolean
              description: >-
                Gibt an, ob Qualifiziert (QES) jetzt signieren kann. Es ist
                `false`, bis ein qualifizierter Anbieter angebunden ist.
        is_bank_verification_enabled:
          type: boolean
          description: >-
            Gibt an, ob ein einfacher KYC- oder KYB-Workflow die
            Bankverifizierung ausführt. Sie läuft nach den Kontaktschritten (und
            der Standortverifizierung) sowie vor der Datenbankvalidierung, AML
            und IP-Analyse. Die Bankverifizierung ist noch nicht allgemein
            verfügbar: Ihre Aktivierung wird überall abgelehnt, wo sie nicht
            freigeschaltet ist.
        bank_verification_config:
          type: object
          additionalProperties: true
          description: >-
            Bankverifizierungseinstellungen eines einfachen Workflows mit
            denselben Schlüsseln, die ein `BANK_VERIFICATION`-Knoten akzeptiert
            (z. B. `bank_countries` und `bank_method_order`). Unbekannte
            Schlüssel werden verworfen. Jeder Schlüssel ist optional, und ein
            fehlender Schlüssel behält seinen Standardwert bei, sodass `{}` für
            alle Standardwerte steht. Siehe
            [Bankverifizierungseinstellungen](/de/management-api/workflows/feature-configs#bank-verifizierung).
          example: {}
        is_geolocation_enabled:
          type: boolean
          description: >-
            Gibt an, ob ein einfacher KYC-Workflow die Standortverifizierung
            ausführt. Sie läuft nach den Kontaktschritten sowie vor der
            Bankverifizierung und Datenbankvalidierung. Unternehmens-Workflows
            (KYB) können sie nicht ausführen.
        geolocation_config:
          type: object
          additionalProperties: true
          description: >-
            Standortverifizierungs-Einstellungen eines einfachen Workflows mit
            denselben Schlüsseln, die ein `GEOLOCATION`-Knoten akzeptiert (zum
            Beispiel `is_geolocation_geofencing_enabled` und
            `geolocation_max_attempts`). Unbekannte Schlüssel werden verworfen.
            Jeder Schlüssel ist optional und ein fehlender Schlüssel behält
            seinen Standardwert, sodass `{}` alle Standardwerte bedeutet.
          example: {}
      additionalProperties: true
    SimpleWorkflowFeature:
      type: object
      required:
        - feature
      properties:
        feature:
          type: string
          description: >-
            Auszuführende Funktion. Verwenden Sie die hier gezeigten Werte in
            Großbuchstaben.
          enum:
            - OCR
            - NFC
            - LIVENESS
            - FACE_MATCH
            - PROOF_OF_ADDRESS
            - QUESTIONNAIRE
            - DOCUMENT_AI
            - PHONE_VERIFICATION
            - EMAIL_VERIFICATION
            - DATABASE_VALIDATION
            - AML
            - IP_ANALYSIS
            - AGE_ESTIMATION
            - KYB_REGISTRY
            - KYB_DOCUMENTS
            - KYB_KEY_PEOPLE
            - SIGNATURE
        config:
          type: object
          description: >-
            Funktionsspezifische Einstellungen. Geben Sie für `QUESTIONNAIRE`
            `questionnaire_uuid` mit der `questionnaire_id` an, die vom Endpoint
            zum Erstellen von Fragebögen zurückgegeben wird. Für `SIGNATURE`
            benötigt ein Workflow, der live geht, ein zu unterzeichnendes
            Dokument: Setzen Sie `signature_documents_source` auf `session` oder
            `both`, damit jede Sitzung eigene Dokumente bereitstellen kann, oder
            senden Sie `status: "draft"` und fügen Sie die Dokumente vor der
            Veröffentlichung hinzu. `signature_level: "aes"` wird mit
            `aes_not_available` abgelehnt, solange `signature_availability.aes`
            im Workflow `false` ist. Für `OCR` wählt `methods` aus, welche
            Methoden der Ausweisverifizierung jedes Land nutzen darf
            (Dokumentenerfassung, dokumentenloser Abgleich mit einer staatlichen
            oder anderen maßgeblichen Quelle und digitale Identitäts-Wallets);
            wird es weggelassen, gilt für jedes Land ausschließlich die
            Dokumentenerfassung. Für `SIGNATURE` siehe
            [E-Signatur-Einstellungen](/de/management-api/workflows/feature-configs#e-signatur):
            `signature_level` akzeptiert derzeit `simple` (Standardwert, keine
            Ausweisverifizierung, E-Mail oder Telefon erforderlich) und `aes`.
            Workflow-Dokumente und deren Felder werden in der Konsole verwaltet;
            senden Sie Dokumente und Felder über die API daher pro Sitzung mit
            `signature_documents_source: "session"`.
          additionalProperties: true
        label:
          type: string
          description: Optionales internes Label für diesen Workflow-Knoten.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in
        der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter
        Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese-
        oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte
        Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und
        auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen
        oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde,
        der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder
        die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei
        einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows
        oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff
        erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne
        Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als
        null. Siehe https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.