> ## 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 per API aktualisieren > Ändern Sie Titel, Priorität, Fälligkeit, Tags oder Prüfteam eines Falls in Didit. Nur gesendete Felder ändern sich; Änderungen werden protokolliert. Prompt für die Update-Case-API Prompt in die Zwischenablage kopieren \

\`Update a case's title, priority, due date, tags or owning review team through the Management API.

Endpoint:
PATCH https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.
Cases endpoints need a full-access API key: a key with restricted access gets 403.

Request body (partial: send only the fields to change, omitted fields keep their value):
\{"priority": "HIGH", "due_at": "2026-11-01T00:00:00Z", "team": ""}
\- title - string, at most 255 characters.
\- priority - LOW | MEDIUM | HIGH.
\- due_at - ISO 8601 datetime, or null to clear the deadline.
\- tags - array of strings. Replaces the whole tag list, so send every tag the case should keep.
\- team - uuid of an active review team of this application, or null to clear the team.

Getting a team uuid:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/teams/ (same full-access key; a console member token needs list:cases) returns results[] with uuid, name and is_active. Only a team with is_active true is accepted.

Behavior:
\- Logs PRIORITY_CHANGED, DUE_DATE_CHANGED, TAG_ADDED, TAG_REMOVED and TEAM_CHANGED events on the case when the value changes.
\- A title change is saved without a timeline event.
\- A TEAM_CHANGED event records the previous and new team as {uuid, name} in its metadata.
\- Changing the team does not reassign the case.

Example call:
curl -X PATCH "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"team": ""}'

Response 200: the updated CaseDetail, the same shape as get case, including team {uuid, name} or null.

Failure modes:
\- 400: a field failed validation, keyed by field. Example: {"team": ["Choose an active team of this application."]} when the team is inactive, deleted, or belongs to another application.
\- 401/403: auth/permission errors. A key with restricted access gets 403 {"detail": "This API key has no access to this endpoint."} (cases need a full-access key). A console member token needs write:cases.
\- 404: case not found in this application.

For the full integration shape, see /integration/integration-prompt.`

\
Einfügen in Ändern Sie den Titel, die Priorität, das Fälligkeitsdatum, die Tags oder das zuständige Prüfteam eines Falls. Senden Sie nur die Felder, die Sie ändern möchten. Ausgelassene Felder behalten ihren Wert. `tags` ersetzt die gesamte Tag-Liste. Senden Sie deshalb jeden Tag, den der Fall behalten soll.## Zuständiges Team ändernSetzen Sie `team` auf die UUID eines aktiven Prüfteams dieser Anwendung oder auf `null`, um das Team zu entfernen. Um die UUID eines Teams zu finden, rufen Sie `GET /v3/organization/{organization_id}/application/{application_id}/cases/teams/` auf und lesen `results[].uuid` aus. Ein Team, das inaktiv oder gelöscht ist oder zu einer anderen Anwendung gehört, führt zu `400` mit `{"team": ["Choose an active team of this application."]}`. Jede Änderung fügt der Zeitleiste des Falls ein Ereignis `TEAM_CHANGED` mit dem bisherigen und dem neuen Team hinzu. Das Ändern des Teams ändert nicht, wem der Fall zugewiesen ist.## ZeitleistenereignisseEine Änderung der Priorität, des Fälligkeitsdatums, der Tags oder des Teams fügt der Zeitleiste des Falls ein Ereignis `PRIORITY_CHANGED`, `DUE_DATE_CHANGED`, `TAG_ADDED`, `TAG_REMOVED` oder `TEAM_CHANGED` hinzu. Eine Titeländerung wird ohne Zeitleistenereignis gespeichert. Wenn Sie ein Feld mit seinem aktuellen Wert senden, wird kein Ereignis hinzugefügt.## ZugriffFür Fall-Endpoints benötigen Sie einen [API-Schlüssel](https://docs.didit.me/de/console/api-keys.md) mit Vollzugriff. Ein Schlüssel mit eingeschränktem Zugriff erhält eine `403`-Antwort. Ein Console-Mitgliedstoken benötigt `write:cases`.## Verwandte Themen- [Fall abrufen](https://docs.didit.me/de/management-api/cases/get.md) - [Fälle auflisten](https://docs.didit.me/de/management-api/cases/list.md) - [Zuweisung und Prüfteams (Console)](https://docs.didit.me/de/console/case-management/assignment.md#teams) ## OpenAPI ````yaml de/openapi-25.json PATCH /v3/organization/{organization_id}/application/{application_id}/cases/{case_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/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/: patch: tags: - Cases summary: Fall aktualisieren description: >- Titel, Priorität, Fälligkeitsdatum, Tags oder zuständiges Prüferteam des Falls aktualisieren. Übertragen Sie nur die Felder, die Sie ändern möchten; weggelassene Felder behalten ihren Wert. `tags` ersetzt die gesamte Tag-Liste. `team` akzeptiert die UUID eines aktiven Prüferteams dieser Anwendung (Listenabruf über `GET .../cases/teams/`) oder null, um die Zuweisung aufzuheben. Erfordert einen API-Schlüssel mit Vollzugriff oder `write:cases` für ein Konsolenmitglied: Ein Schlüssel mit eingeschränktem Zugriff erhält 403. Protokolliert je nach Änderung die Ereignisse PRIORITY_CHANGED, DUE_DATE_CHANGED, TAG_ADDED, TAG_REMOVED und TEAM_CHANGED; eine Titeländerung wird ohne Timeline-Ereignis gespeichert. Gibt den aktualisierten Fall zurück. operationId: update_case 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. - name: case_uuid in: path required: true schema: type: string format: uuid example: c1a5e000-0000-4000-8000-000000000001 description: Fall-UUID. requestBody: required: false content: application/json: schema: type: object properties: title: type: string maxLength: 255 description: Neuer Falltitel. priority: type: string enum: - LOW - MEDIUM - HIGH due_at: type: string format: date-time nullable: true description: Neue Frist. Senden Sie null, um sie zu löschen. tags: type: array items: type: string description: Die vollständige Tag-Liste. Sie ersetzt die aktuellen Tags. team: type: string format: uuid nullable: true description: >- UUID des Prüfungsteams, dem der Fall gehört. Es muss ein aktives Team dieser Anwendung sein. Senden Sie null, um das Team zu entfernen. examples: Change priority and deadline: value: priority: HIGH due_at: '2026-11-01T00:00:00Z' Move the case to a team: value: team: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Clear the team: value: team: null responses: '200': description: Aktualisierter Fall. content: application/json: schema: $ref: '#/components/schemas/CaseDetail' '400': description: >- Ein Feld hat die Validierung nicht bestanden. Der Body ist nach Feldnamen gegliedert. `team` wird abgelehnt, wenn es kein aktives Prüfteam dieser Anwendung ist. content: application/json: schema: type: object additionalProperties: type: array items: type: string examples: Team not active in this application: value: team: - Choose an active team of this application. Invalid priority: value: priority: - '"URGENT" is not a valid choice.' '403': description: >- Der API-Schlüssel gehört zu einer anderen Anwendung oder ist ein Schlüssel mit eingeschränktem Zugriff: Cases-Endpoints erfordern einen Schlüssel mit Vollzugriff. Ein Konsolen-Mitgliedstoken benötigt `write:cases`. content: application/json: examples: Restricted API Key: summary: API-Schlüssel mit eingeschränktem Zugriff value: detail: This API key has no access to this endpoint. Missing Privilege: summary: >- Console-Mitglied ohne write:cases oder Schlüssel einer anderen Anwendung value: detail: You do not have permission to perform this action. '404': description: Fall in dieser Anwendung nicht gefunden. content: application/json: schema: type: object properties: detail: type: string example: detail: No Case matches the given query. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X PATCH 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"priority": "HIGH", "due_at": "2026-08-01T00:00:00Z"}' - lang: curl label: curl (change team) source: >- curl -X PATCH 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"team": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.cases.update( "c1a5e000-0000-4000-8000-000000000001", priority="HIGH", due_at="2026-11-01T00:00:00Z", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.cases.update("c1a5e000-0000-4000-8000-000000000001", { priority: "HIGH", due_at: "2026-11-01T00:00:00Z", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.Update(ctx, \"c1a5e000-0000-4000-8000-000000000001\", didit.CasesUpdateParams{\n\tPriority: didit.Some(didit.CasesUpdateParamsPriority(\"HIGH\")),\n\tDueAt: didit.Time(time.Date(2026, 11, 1, 0, 0, 0, 0, time.UTC)),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.time.OffsetDateTime; import me.didit.Didit; import me.didit.types.CasesUpdateParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().update("c1a5e000-0000-4000-8000-000000000001", CasesUpdateParams.builder() .priority(CasesUpdateParams.Priority.of("HIGH")) .dueAt(OffsetDateTime.parse("2026-11-01T00:00:00Z")) .build()); System.out.println(result); - lang: php label: PHP source: >- cases->update('c1a5e000-0000-4000-8000-000000000001', [ 'priority' => 'HIGH', 'due_at' => '2026-11-01T00:00:00Z', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.cases.update( "c1a5e000-0000-4000-8000-000000000001", priority: "HIGH", due_at: "2026-11-01T00:00:00Z" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Cases.UpdateAsync("c1a5e000-0000-4000-8000-000000000001", new CasesUpdateParams { Priority = new CasesUpdateParamsPriority("HIGH"), DueAt = DateTimeOffset.Parse("2026-11-01T00:00:00Z"), }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseDetail: type: object properties: uuid: type: string format: uuid case_number: type: string nullable: true title: type: string status: type: string enum: - OPEN - AWAITING_USER - RESOLVED resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED nullable: true resolution_notes: type: string nullable: true priority: type: string enum: - LOW - MEDIUM - HIGH source: type: string enum: - MANUAL - AML_SCREENING - TRANSACTION_RULE - WORKFLOW_BUILDER tags: type: array items: type: string subject: $ref: '#/components/schemas/CaseSubject' assigned_to: $ref: '#/components/schemas/CaseAssignee' assigned_at: type: string format: date-time nullable: true team: $ref: '#/components/schemas/CaseTeamSummary' due_at: type: string format: date-time nullable: true resolved_at: type: string format: date-time nullable: true resolved_by_email: type: string nullable: true pending_resolution: type: object nullable: true description: >- Wird nur gesetzt, während eine 4-Augen-Auflösung auf der Checker-Vorlage bereitgestellt ist und auf Genehmigung oder Ablehnung der Genehmigung wartet. properties: resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED resolution_notes: type: string nullable: true maker_email: type: string format: email nullable: true description: >- E-Mail des Beauftragten, der den Beschluss eingereicht hat. Null, wenn er über einen API-Schlüssel eingereicht wurde: Dieser Beschluss hat keinen erfassten Ersteller, sodass approve und reject-approval für jeden Aufrufer 403 zurückgeben. maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- Benutzer-UUID des Mitglieds, das als Beauftragter die Entscheidung eingereicht hat. Null, wenn sie über einen API-Schlüssel eingereicht wurde. Dieses Mitglied kann nicht als `checker` benannt werden. maker_blueprint_id: type: string format: uuid staged_at: type: string format: date-time checker: $ref: '#/components/schemas/CaseChecker' metadata: type: object blueprint: $ref: '#/components/schemas/CaseBlueprintDetail' notes: type: array items: $ref: '#/components/schemas/CaseNote' description: Neueste 50 Notizen. events: type: array items: $ref: '#/components/schemas/CaseEvent' description: Neueste 100 Ereignisse. links: type: array items: $ref: '#/components/schemas/CaseLink' links_count: type: integer notes_count: type: integer checklist_items: type: array items: $ref: '#/components/schemas/CaseChecklistItem' created_at: type: string format: date-time updated_at: type: string format: date-time CaseSubject: type: object nullable: true description: >- Der einzelne Benutzer oder das Unternehmen, an den bzw. das der Fall gebunden ist. properties: type: type: string enum: - user - business uuid: type: string format: uuid name: type: string external_id: type: string nullable: true description: Die vendor_data des Subjekts. country: type: string nullable: true description: >- Dreistelliger Ländercode des Subjekts (ISO 3166-1 Alpha-3) oder null, wenn unbekannt. Bei einem Unternehmen das Land der Gründung. Bei einer Person das Ausstellungsland eines Ausweisdokuments aus deren Verifizierungen; bei einer Person mit Dokumenten aus mehreren Ländern wird eines davon angezeigt, und es können ICAO-Dokumentencodes wie `XXA` vorkommen. example: ESP portrait: type: string format: uri nullable: true description: >- Kurzlebige signierte URL des Porträtbildes der Person. Für ein Unternehmen immer null und null für eine Person ohne Porträt. Die URL läuft ab, laden Sie das Bild daher beim Lesen des Falls herunter, anstatt die URL zu speichern. CaseAssignee: type: object nullable: true properties: uuid: type: string format: uuid full_name: type: string email: type: string format: email CaseTeamSummary: type: object nullable: true description: >- Das Prüfungsteam, das für den Fall zuständig ist, oder null, wenn kein Team zuständig ist. Das Routing legt dies fest, wenn eine Routing-Regel den Fall einem ihrer Teams zuweist. Ändern oder löschen Sie dies mit `PATCH .../cases/{case_uuid}/` (`team`). properties: uuid: type: string format: uuid name: type: string CaseChecker: type: object nullable: true description: >- Das benannte Mitglied zur Genehmigung oder Ablehnung des ausstehenden Beschlusses. Nur gesetzt, während ein Vier-Augen-Beschluss auf einen benannten Prüfer wartet. Null, wenn nichts aussteht, während der ausstehende Beschluss in der Prüfer-Warteschlange wartet und sobald der Beschluss genehmigt, abgelehnt oder aufgrund geänderter Nachweise zur erneuten Prüfung zurückgegeben wurde. properties: member_uuid: type: string format: uuid description: >- Die Benutzer-UUID des Mitglieds: der Wert, den Sie als `checker` übergeben, wenn Sie den Fall lösen. name: type: string nullable: true description: >- Der vollständige Name des Mitglieds oder null, wenn er nicht bekannt ist. email: type: string format: email CaseBlueprintDetail: type: object properties: uuid: type: string format: uuid name: type: string maxLength: 24 description: type: string nullable: true assignment_method: type: string enum: - MANUAL - AUTOMATIC assignee_pool: type: array items: type: string format: uuid max_active_cases: type: integer nullable: true escalation_enabled: type: boolean transfer_enabled: type: boolean require_resolution_note: type: boolean is_active: type: boolean preset_key: type: string nullable: true created_at: type: string format: date-time escalation_blueprint: type: string format: uuid nullable: true escalation_blueprint_name: type: string nullable: true four_eyes_checker_blueprint: type: string format: uuid nullable: true four_eyes_checker_blueprint_name: type: string nullable: true content_config: type: object description: >- Die sechs umschaltbaren Abschnitte, die steuern, welche Tabs und Felder auf der Fallseite erscheinen. Unbekannte Abschnitte oder Schlüssel werden abgelehnt. 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 creation_sources: type: array description: Konnektoren, die derzeit neue Fälle in diese Vorlage leiten. items: type: object properties: kind: type: string enum: - aml - rule - workflow id: type: string name: type: string receives_escalation_from: type: array description: Andere Blueprints, deren Eskalationsziel auf diesen verweist. items: type: object properties: id: type: string name: type: string updated_at: type: string format: date-time version: type: integer readOnly: true default_deadline_hours: type: integer nullable: true minimum: 1 maximum: 8760 CaseNote: type: object properties: uuid: type: string format: uuid comment: type: string actor_email: type: string format: email nullable: true actor_name: type: string nullable: true mentioned_emails: type: array items: type: string format: email is_internal: type: boolean attachments: type: array items: type: object properties: s3_key: type: string filename: type: string file_size: type: integer url: type: string format: uri tags: type: array items: type: string created_at: type: string format: date-time CaseEvent: type: object properties: uuid: type: string format: uuid event_type: type: string enum: - CREATED - STATUS_CHANGED - ASSIGNED - UNASSIGNED - RESOLVED - REOPENED - LINK_ADDED - LINK_REMOVED - NOTE_ADDED - NOTE_PINNED - NOTE_UNPINNED - PRIORITY_CHANGED - DUE_DATE_CHANGED - TAG_ADDED - TAG_REMOVED - ESCALATED - TRANSFERRED - CHECKLIST_COMPLETED - REPORT_CREATED - REPORT_FINALIZED - SUBMITTED_FOR_APPROVAL - APPROVAL_GRANTED - APPROVAL_REJECTED - ENTITY_ACTION - APPROVAL_INVALIDATED - CUSTOMER_REQUEST - STAGE_CHANGED - TEAM_CHANGED - CHECKER_ASSIGNED - CHECKER_UNASSIGNED actor_email: type: string format: email nullable: true actor_name: type: string nullable: true previous_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true new_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true metadata: type: object created_at: type: string format: date-time CaseLink: type: object properties: uuid: type: string format: uuid linked_entity_type: type: string enum: - session - business_session - transaction nullable: true linked_entity_uuid: type: string format: uuid nullable: true linked_entity_summary: type: object nullable: true description: >- session_id/session_number/status für Sitzungs- und business_session-Links; uuid/txn_id/status für Transaktions-Links. created_at: type: string format: date-time CaseChecklistItem: type: object properties: uuid: type: string format: uuid label: type: string maxLength: 255 is_completed: type: boolean completed_by: type: string format: email nullable: true completed_at: type: string format: date-time nullable: true order: type: integer 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.