> ## 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 löschen API > Löschen Sie in Didit einen Compliance-Fall und seine Berichtsentwürfe. Ein finalisierter Bericht blockiert die Löschung, bis Sie ihn löschen. API-Prompt zum Löschen eines Falls Prompt in die Zwischenablage kopieren 
  \`Delete a compliance case through the Management API.

  Endpoint:
  DELETE [https://verification.didit.me/v3/organization/\{organization\_id}/application/\{application\_id}/cases/\{case\_uuid}/](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. Use a full-access API key; the caller needs write:cases.

  Request body: none.

  Example call:
  curl -X DELETE "[https://verification.didit.me/v3/organization/\{organization\_id}/application/\{application\_id}/cases/\{case\_uuid}/](https://verification.didit.me/v3/organization/\{organization_id}/application/\{application_id}/cases/\{case_uuid}/)" \
  -H "x-api-key: YOUR\_API\_KEY"

  Response 204: the case is deleted.

  What is deleted:

  * The case.
  * Its draft regulatory reports.
    Linked verifications, people, companies and transactions are NOT deleted. There is no undelete endpoint.

  Failure modes:

  * 409 - the case has a finalized regulatory report. Nothing is deleted. The body has code: in\_filed\_report and names each report with uuid, report\_number, report\_type and case\_uuid. Delete the reports, then repeat this request.
  * 403 - the key cannot delete cases (requires a full-access key and write:cases).
  * 404 - the case does not exist in this application or was already deleted.

  For the full integration shape, see /integration/integration-prompt.\`
Einfügen in Löscht einen Fall dauerhaft. Die zugehörigen Entwürfe regulatorischer Berichte werden mit ihm gelöscht. Verknüpfte Verifizierungen, Personen, Unternehmen und Transaktionen werden **nicht** gelöscht. Es gibt keinen Endpoint zur Wiederherstellung. ## Durch einen abgeschlossenen Bericht blockiert Hat der Fall einen abgeschlossenen regulatorischen Bericht, gibt die gesamte Anfrage `409` zurück und es wird nichts gelöscht: ```json theme={null} { "detail": "This case has a finalized regulatory report, so it cannot be deleted.", "code": "in_filed_report", "reports": [ { "uuid": "5ec00000-0000-4000-8000-000000000007", "report_number": "SAR-0001", "report_type": "SAR", "case_uuid": "c1a5e000-0000-4000-8000-000000000001" } ] } ``` Löschen Sie jeden Bericht mit [Bericht löschen](https://docs.didit.me/de/management-api/regulatory-reports/delete.md) und wiederholen Sie dann diese Anfrage. Der Fall kann gelöscht werden, sobald kein abgeschlossener Bericht mehr vorhanden ist. ## Verwandte Themen * [Fall abrufen](https://docs.didit.me/de/management-api/cases/get.md) * [Fall aktualisieren](https://docs.didit.me/de/management-api/cases/update.md) * [Bericht löschen](https://docs.didit.me/de/management-api/regulatory-reports/delete.md) * [Fälle (Konsole)](https://docs.didit.me/de/console/case-management/cases.md) ## OpenAPI ````yaml de/openapi-25.json DELETE /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}/: delete: tags: - Cases summary: Fall löschen description: >- Einen Fall dauerhaft löschen. Die zugehörigen Entwürfe regulatorischer Berichte werden mitgelöscht. Verknüpfte Verifizierungen, Personen, Unternehmen und Transaktionen werden nicht gelöscht. Es gibt keinen Endpoint zur Wiederherstellung. Enthält der Fall einen finalisierten regulatorischen Bericht, wird die gesamte Anfrage mit `409` abgelehnt und nichts gelöscht. Der Body verwendet `code: in_filed_report` und gibt für jeden Bericht `uuid`, `report_number`, `report_type` und `case_uuid` an. Löschen Sie die Berichte und wiederholen Sie die Anfrage anschließend. operationId: delete_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. responses: '204': description: Fall gelöscht. '403': description: >- Der Schlüssel kann keine Fälle löschen. Er erfordert einen Vollzugriffsschlüssel mit `write:cases`. content: application/json: schema: type: object properties: detail: type: string '404': description: >- Der Fall existiert in dieser Anwendung nicht oder wurde bereits gelöscht. content: application/json: schema: type: object properties: detail: type: string '409': description: >- Der Fall hat einen finalisierten regulatorischen Bericht. Es wird nichts gelöscht. content: application/json: schema: $ref: '#/components/schemas/InFiledReportError' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE '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' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() client.cases.delete( "c1a5e000-0000-4000-8000-000000000001", ) - 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(); await didit.cases.delete("c1a5e000-0000-4000-8000-000000000001"); - 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\nif err := client.Cases.Delete(ctx, \"c1a5e000-0000-4000-8000-000000000001\"); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); client.cases().delete("c1a5e000-0000-4000-8000-000000000001"); - lang: php label: PHP source: |- cases->delete('c1a5e000-0000-4000-8000-000000000001'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new didit.cases.delete("c1a5e000-0000-4000-8000-000000000001") - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); await client.Cases.DeleteAsync("c1a5e000-0000-4000-8000-000000000001"); components: schemas: InFiledReportError: type: object description: >- Die Löschung wird verweigert, da sich die ausgewählten Daten in einem abgeschlossenen regulatorischen Bericht befinden. Es wird nichts gelöscht. Löschen Sie den Bericht und wiederholen Sie die Anfrage. required: - detail - code properties: detail: type: string code: type: string enum: - in_filed_report description: >- Stabiler Fehlercode für eine Löschung, die durch einen finalisierten regulatorischen Bericht blockiert wird. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: >- Berichte, die das Löschen einer Person, eines Unternehmens, eines Falls oder einer Sitzung blockieren. transactions: type: array items: $ref: '#/components/schemas/FiledReportTransaction' description: >- Transaktionen, die das Löschen einer Transaktion blockieren, jeweils mit den Berichten, in denen sie aufgeführt sind. FiledRegulatoryReport: type: object description: >- Ein finalisierter regulatorischer Bericht, der die angeforderte Löschung verhindert. required: - uuid - report_number - report_type - case_uuid properties: uuid: type: string format: uuid description: Berichts-UUID. report_number: type: string description: In der Console angezeigte Berichtsnummer (z. B. SAR-0001). report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: Art des aufsichtsrechtlichen Berichts. case_uuid: type: string format: uuid description: Fall, zu dem der Bericht gehört. FiledReportTransaction: type: object description: >- Eine Transaktion, die nicht gelöscht werden kann, da ein abgeschlossener regulatorischer Bericht sie auflistet. required: - uuid - transaction_id - reports properties: uuid: type: string format: uuid description: Didit-Transaktions-UUID. transaction_id: type: string description: >- Die Transaktionskennung, die bei der Erstellung der Transaktion angegeben wurde. reports: type: array items: $ref: '#/components/schemas/FiledRegulatoryReport' description: Abgeschlossene Berichte, die diese Transaktion aufführen. 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.