> ## 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. # Überwachungsereignis löschen – Didit Management API > Didit löscht ein Überwachungsereignis dauerhaft samt Regelläufen, Notizen und Tags. Unwiderruflich, danach in keiner Abfrage mehr sichtbar. API-Prompt zum Löschen eines Überwachungsereignisses Prompt in die Zwischenablage kopieren 
  \`Permanently delete one monitoring event from my Didit application.

  Endpoint:
  DELETE [https://verification.didit.me/v3/events/\{event\_uuid}/delete/](https://verification.didit.me/v3/events/\{event_uuid}/delete/)

  Authentication:
  Use the x-api-key header with my Didit API key. A scoped key needs transactions: write.

  Goal:

  * Delete a single event, for example one sent by mistake. To erase everything about a person or a company, delete the user or the company instead, which also deletes their events.

  Behavior:

  * event\_uuid is the Didit id of the event (from the create, batch, list or timeline response), not my own event\_id.
  * The event is deleted together with its rule runs, notes and tag links.
  * After a 204 the event no longer appears in any read: GET /v3/events/{event_uuid}/ returns 404 and it is gone from the list and the subject timeline.
  * Deletion is irreversible. A second call returns 404.
  * Not affected: the user or company the event resolved to, cases a rule opened, and list entries a rule added. They are separate records with their own lifecycle.
  * The event\_id becomes free: a later POST /v3/events/ with it stores a new event.

  Example call:
  curl -X DELETE "[https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/delete/](https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/delete/)" \
  -H "x-api-key: YOUR\_API\_KEY"

  What to read from the response:

  * 204 No Content means the event was deleted. There is no body.

  Failure modes:

  * 401 - the API key has expired.
  * 403 - missing API key (a wrong, revoked or expired key gets 401), or a scoped key without transactions: write.
  * 404 - no event with this event\_uuid in the application (already deleted, never stored, or another application's).

  Side effects: permanently deletes the event. This cannot be undone.

  For the full integration shape, see /integration/integration-prompt.\`
Einfügen in > [!WARNING] > > Das Löschen eines Ereignisses ist nicht rückgängig zu machen. Um alle Daten zu einer Person oder einem Unternehmen zu entfernen, [löschen Sie den Benutzer](https://docs.didit.me/de/management-api/users/delete.md) bzw. [löschen Sie das Unternehmen](https://docs.didit.me/de/management-api/businesses/delete.md), statt deren Ereignisse einzeln zu löschen: Dabei werden auch deren Ereignisse gelöscht. ## OpenAPI ````yaml de/openapi-25.json DELETE /v3/events/{event_uuid}/delete/ 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/events/{event_uuid}/delete/: delete: tags: - Monitoring Events summary: Monitoring-Ereignis löschen description: >- Ein Überwachungsereignis zusammen mit seinen Regelläufen, Notizen und Tag-Verknüpfungen dauerhaft löschen, beispielsweise ein versehentlich gesendetes Ereignis. Nach dem `204` ist das Ereignis bei jedem Lesevorgang nicht mehr vorhanden (Abrufen gibt `404` zurück und es erscheint nicht mehr in der Liste oder der Betreff-Timeline), die Löschung ist unwiderruflich und seine `event_id` kann wieder für ein neues Ereignis verwendet werden. Nicht betroffen: der Benutzer oder das Unternehmen, dem das Ereignis zugeordnet war, von einer Regel eröffnete Fälle, von einer Regel hinzugefügte Listeneinträge sowie die bereits auf andere Ereignisse angewendeten Scores und Status. Um alle Daten zu einer Person oder einem Unternehmen zu löschen, löschen Sie stattdessen den Benutzer oder das Unternehmen, wodurch auch deren Ereignisse gelöscht werden. Ein API-Schlüssel mit Scopes erfordert `transactions: write`. operationId: delete_monitoring_event parameters: - name: event_uuid in: path required: true description: >- Didit-Kennung des Ereignisses (`event_uuid` aus der Create-, Batch-, List- oder Timeline-Antwort), nicht Ihre eigene `event_id`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: Das Ereignis wurde gelöscht. Kein Inhalt. '401': description: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Nur ein abgelaufener Schlüssel erhält `401`; ein fehlender oder ungültiger Schlüssel erhält `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Ein fehlender `x-api-key` (ein falscher, widerrufener oder abgelaufener Schlüssel erhält `401`), ein berechtigungsbeschränkter Schlüssel ohne `transactions: write`, ein auf bestimmte Workflows oder genehmigte Sitzungen beschränkter Schlüssel (ein solcher Schlüssel erreicht Transaktionsüberwachungsdaten nie) oder eine Anfrage von außerhalb der IP-Allowlist des Schlüssels. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without access: value: detail: This API key has no write access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. IP not allowed: value: detail: This API key can't be used from this IP address. '404': description: >- In der Anwendung existiert kein Ereignis mit dieser `event_uuid`: Es wurde nie gespeichert, es wurde gelöscht oder es gehört zu einer anderen Anwendung. Ein Pfadsegment, das keine UUID ist, stimmt nicht mit der Route überein und gibt ebenfalls `404` zurück. content: application/json: examples: Not found: value: detail: No MonitoringEvent matches the given query. '429': description: >- Rate-Limit überschritten: Schreibanfragen (`POST`, `PATCH`, `DELETE`) teilen sich ein Kontingent von 300 Anfragen pro Minute pro API-Schlüssel. Warten Sie `Retry-After` Sekunden und versuchen Sie es dann erneut. headers: Retry-After: description: >- Sekunden, die vor einem Wiederholungsversuch gewartet werden müssen. schema: type: integer minimum: 1 example: 30 content: application/json: examples: Throttled: value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/delete/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.monitoring_events.delete( "11111111-2222-3333-4444-555555555555", ) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); await didit.monitoringEvents.delete("11111111-2222-3333-4444-555555555555"); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nif err := client.MonitoringEvents.Delete(ctx, \"11111111-2222-3333-4444-555555555555\"); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.monitoringEvents().delete("11111111-2222-3333-4444-555555555555"); - lang: php label: PHP source: >- monitoringEvents->delete('11111111-2222-3333-4444-555555555555'); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.monitoring_events.delete("11111111-2222-3333-4444-555555555555") - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await client.MonitoringEvents.DeleteAsync("11111111-2222-3333-4444-555555555555"); components: 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.