> ## 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.

# Fall-Blueprint mit KI-API entwerfen

> Mit Didit aus einem Prompt einen ungespeicherten Fall-Blueprint-Entwurf erstellen, Stufen und Falltypen prüfen und Richtlinien separat speichern.

Didits Blueprint-API für KI-Entwürfe wandelt eine Richtlinienbeschreibung in einen nicht gespeicherten Vorschlag für eine Prüfrichtlinie um.
Authentifizieren Sie sich mit `x-api-key` und der Berechtigung `write:cases` für die Anwendung.

## Vorschlag erzeugen und prüfen

Senden Sie einen nicht leeren `prompt` mit höchstens 4000 Zeichen. Die Antwort enthält den Statuscode `200` und ein `draft`-Objekt, nicht einen gespeicherten Blueprint oder eine UUID.

```json theme={null}
{"prompt": "Draft an AML review policy with triage and evidence review stages."}
```

Der Vorschlag kann `name`, `description`, `applies_to`, `content_config`, `require_resolution_note`, `assignment_method`, `max_active_cases` und `default_deadline_hours` enthalten. Felder können fehlen, prüfen Sie die Antwort daher, bevor Sie sie verwenden. Der Vorschlag auf oberster Ebene enthält keine Bearbeiterlisten, Genehmigungseinstellungen und Routing-Referenzen.

Wählen Sie Bearbeiter, Teams, Genehmigungen und Routing selbst aus, bevor Sie speichern. Wenn eine generierte Phase `worked_by` enthält, wird es in der Anwendung als UUID eines aktiven Prüfteams validiert. Behandeln Sie einen Vorschlag nicht als genehmigte Zuweisung.

Verwenden Sie nach der Prüfung [Case-Blueprint erstellen](https://docs.didit.me/de/management-api/case-blueprints/create.md), einschließlich des erforderlichen `name` und eines nicht leeren `assignee_pool`. Das Erzeugen eines Vorschlags speichert keinen Richtlinienentwurf, veröffentlicht keine Richtlinie und ändert keine bestehenden Fälle. Der [Lebenszyklus für gespeicherte Entwürfe und Veröffentlichung](https://docs.didit.me/de/console/case-management/blueprints.md#speichern-und-veröffentlichen-von-richtlinienänderungen) ist davon getrennt.

## Fehler

| Status | Bedeutung |
| - | - |
| `400` | Prompt fehlt, ist leer oder zu lang |
| `401` / `403` | Authentifizierung oder Berechtigung fehlt |
| `404` | Anwendung nicht gefunden |
| `503` | Generierung fehlgeschlagen oder Vorschlag hat die Validierung nicht bestanden; später erneut versuchen |

Bei einem Generierungsfehler wird Folgendes zurückgegeben:

```json theme={null}
{"detail": "A blueprint draft could not be generated. Please try again."}
```

## Verwandte Themen

* [Fallvorlagen auflisten](https://docs.didit.me/de/management-api/case-blueprints/list.md)
* [Einstellungen der Vorlagen und Prüfrichtlinien](https://docs.didit.me/de/console/case-management/blueprints.md)


## OpenAPI

````yaml de/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/blueprints/ai-draft/
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/organization/{organization_id}/application/{application_id}/cases/blueprints/ai-draft/:
    post:
      tags:
        - Case Blueprints
      summary: Entwurf einer Fallvorlage mit KI erstellen
      description: >-
        Generiert einen nicht gespeicherten Blueprint-Vorschlag. Erfordert
        write:cases. Gibt ein Entwurfsobjekt zurück, keine Blueprint-UUID; es
        wird weder ein Blueprint noch ein gespeicherter Richtlinienentwurf
        erstellt. Prüfen Sie den Vorschlag, wählen Sie Bearbeiter sowie
        gegebenenfalls Teams, Genehmigungen oder Weiterleitungen aus und
        erstellen oder aktualisieren Sie anschließend separat einen Blueprint.
        Ungültige generierte Inhalte oder ein Fehler bei der Generierung führen
        zu 503. Siehe [KI-Entwürfe für
        Blueprints](/de/management-api/case-blueprints/ai-draft).
      operationId: draft_case_blueprint
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID der Organisation.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Anwendungs-UUID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CaseBlueprintAiDraftRequest'
            example:
              prompt: >-
                Draft an AML review policy with triage and evidence review
                stages.
      responses:
        '200':
          description: Nicht gespeicherter Vorschlag. Es wurde kein Status geändert.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseBlueprintAiDraftResponse'
              example:
                draft:
                  name: AML review
                  applies_to:
                    - AML
                  require_resolution_note: true
                  content_config:
                    stages:
                      items:
                        - key: triage
                          label: Triage
                          sla_hours: 24
        '400':
          description: prompt fehlt, ist leer oder länger als 4000 Zeichen.
        '401':
          description: Authentifizierung ist erforderlich.
        '403':
          description: Die Berechtigung write:cases ist erforderlich.
        '404':
          description: Anwendung nicht gefunden.
        '503':
          description: >-
            Die Generierung ist fehlgeschlagen oder hat einen ungültigen
            Vorschlag erzeugt. Versuchen Sie es später erneut.
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    type: string
              example:
                detail: A blueprint draft could not be generated. Please try again.
      security:
        - ApiKeyAuth: []
      x-codeSamples: []
components:
  schemas:
    CaseBlueprintAiDraftRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          minLength: 1
          maxLength: 4000
          description: Nicht leere Beschreibung der vorzuschlagenden Prüfrichtlinie.
          example: Draft an AML review policy with triage and evidence review stages.
    CaseBlueprintAiDraftResponse:
      type: object
      required:
        - draft
      properties:
        draft:
          $ref: '#/components/schemas/CaseBlueprintAiDraft'
    CaseBlueprintAiDraft:
      type: object
      additionalProperties: false
      description: >-
        Nicht gespeicherter, validierter Vorschlag. Die Felder sind optional;
        prüfen Sie das Ergebnis und wählen Sie Bearbeiter, Teams und
        Weiterleitung aus, bevor Sie speichern.
      properties:
        name:
          type: string
          maxLength: 24
          description: Maximal 24 Zeichen, z. B. „AML investigation“.
        description:
          type: string
          nullable: true
        content_config:
          $ref: '#/components/schemas/CaseContentConfig'
        require_resolution_note:
          type: boolean
        assignment_method:
          type: string
          enum:
            - MANUAL
            - AUTOMATIC
        max_active_cases:
          type: integer
          nullable: true
          minimum: 1
          description: >-
            Schwellenwert für den Automatikmodus: „weniger als N Fälle dieser
            Vorlage zugewiesen“.
        default_deadline_hours:
          type: integer
          nullable: true
          minimum: 1
          maximum: 8760
          description: >-
            Standardfrist für neu geöffnete Fälle. Fristen bestehender Fälle
            bleiben unverändert.
        applies_to:
          $ref: '#/components/schemas/CaseBlueprintAppliesTo'
    CaseContentConfig:
      type: object
      description: >-
        Abschnitte mit Falldaten und optionale Prüfschritte. Unbekannte
        Abschnitte oder Schlüssel werden abgelehnt. Fälle behalten den beim
        Öffnen akzeptierten Richtlinien-Snapshot; spätere Änderungen am
        Blueprint schreiben ihn nicht um.
      properties:
        checklist:
          type: object
          properties:
            enabled:
              type: boolean
            optional:
              type: boolean
              description: >-
                Wenn true, kann ein Fall mit unvollständigen
                Checklisten-Einträgen abgeschlossen werden.
            items:
              type: array
              items:
                type: object
                properties:
                  label:
                    type: string
                    maxLength: 255
                  order:
                    type: integer
        aml_control:
          type: object
          properties:
            enabled:
              type: boolean
            financial:
              type: boolean
            identity:
              type: boolean
        identity:
          type: object
          properties:
            enabled:
              type: boolean
            personal_information:
              type: boolean
            applicant_tags:
              type: boolean
            contact_information:
              type: boolean
            risk_overview:
              type: boolean
            poi_documents:
              type: boolean
            poa_documents:
              type: boolean
        verifications:
          type: object
          properties:
            enabled:
              type: boolean
            summary:
              type: boolean
        reporting:
          type: object
          properties:
            enabled:
              type: boolean
            fiu_reports:
              type: boolean
        financial:
          type: object
          properties:
            enabled:
              type: boolean
            payment_methods:
              type: boolean
            transactions:
              type: boolean
        stages:
          type: object
          additionalProperties: false
          description: >-
            Geordnete Prüfstufen. Nicht angegebene oder leere Elemente verwenden
            die Standardstufen Triage, Nachweisprüfung und Entscheidung.
          properties:
            items:
              type: array
              maxItems: 10
              items:
                $ref: '#/components/schemas/CaseBlueprintStage'
              description: >-
                Höchstens zehn Schritte mit eindeutigen Schlüsseln. Das
                Abschließen eines Falls ist eine Statusänderung, kein Schritt.
    CaseBlueprintAppliesTo:
      type: array
      maxItems: 6
      items:
        type: string
        enum:
          - GENERAL
          - VERIFICATION_REVIEW
          - BUSINESS_REVIEW
          - AML
          - TRANSACTION_MONITORING
          - DUPLICATES
      description: >-
        Fallarten, die dieser Blueprint beschreibt. Beim Erstellen und
        Aktualisieren optional; neue Blueprints verwenden standardmäßig eine
        leere Liste. Wird im akzeptierten Fall-Richtlinien-Snapshot gespeichert.
      example:
        - AML
    CaseBlueprintStage:
      type: object
      additionalProperties: false
      required:
        - label
      properties:
        key:
          type: string
          pattern: ^[a-z0-9_]{1,64}$
          description: >-
            Innerhalb der Richtlinie eindeutig. Weglassen, um den Schlüssel aus
            dem Label abzuleiten. Der aufgelöste Schlüssel ist reserviert.
          example: triage
        label:
          type: string
          minLength: 1
          maxLength: 64
          description: Nicht leere Bezeichnung der Stufe.
          example: Triage
        sla_hours:
          type: integer
          minimum: 1
          maximum: 8760
          nullable: true
          description: SLA der Phase in Stunden, oder null für kein SLA.
          example: 24
        worked_by:
          type: string
          format: uuid
          nullable: true
          description: >-
            Optionale UUID des Prüfteams. Ein Wert ungleich null muss ein
            aktives Team in dieser Anwendung bezeichnen. Um kein Stufenteam
            festzulegen, lassen Sie den Wert weg oder verwenden Sie null.
          example: a0000000-0000-4000-8000-000000000001
  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.