> ## 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. # Supprimer un événement de surveillance (API) > Supprimez définitivement un événement de surveillance Didit, avec ses exécutions de règles, notes et tags. Suppression irréversible. Prompt de l'API de suppression d'un événement de surveillance Copier le prompt dans le presse-papiers 
  \`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.\`
Coller dans > [!WARNING] > > La suppression d'un événement est irréversible. Pour effacer toutes les données d'une personne ou d'une entreprise, [supprimez l'utilisateur](https://docs.didit.me/fr/management-api/users/delete.md) ou [supprimez l'entreprise](https://docs.didit.me/fr/management-api/businesses/delete.md) plutôt que de supprimer leurs événements un par un : cette action supprime aussi leurs événements. ## OpenAPI ````yaml fr/openapi-25.json DELETE /v3/events/{event_uuid}/delete/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/{event_uuid}/delete/: delete: tags: - Monitoring Events summary: Supprimer l'événement de surveillance description: "Supprime définitivement un événement de surveillance ainsi que ses exécutions de règles, notes et liens d'étiquettes, par exemple un événement envoyé par erreur. Après le `204`, l'événement disparaît de toute lecture (la récupération renvoie `404`, et il n'apparaît plus dans la liste ni dans la chronologie du sujet), la suppression est irréversible, et son `event_id` peut être réutilisé pour un nouvel événement. Ne sont pas affectés\_: l'utilisateur ou l'entreprise auquel ou à laquelle l'événement a été rattaché, les dossiers ouverts par une règle, les entrées de liste ajoutées par une règle, ainsi que les scores et statuts déjà appliqués à d'autres événements. Pour effacer tout ce qui concerne une personne ou une entreprise, supprimez plutôt l'utilisateur ou l'entreprise, ce qui supprime également ses événements. Une clé API restreinte nécessite `transactions: write`." operationId: delete_monitoring_event parameters: - name: event_uuid in: path required: true description: >- Identifiant Didit de l'événement (`event_uuid` issu de la réponse de création, de lot, de liste ou de chronologie), et non votre propre `event_id`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: L'événement a été supprimé. Aucun corps. '401': description: >- La clé API restreinte a expiré. Seule une clé expirée renvoie `401` ; une clé manquante ou invalide renvoie `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Un en-tête `x-api-key` manquant (une clé erronée, révoquée ou expirée renvoie `401`), une clé restreinte sans `transactions: write`, une clé limitée à certains workflows ou à des sessions approuvées (une telle clé n'accède jamais aux données de surveillance des transactions), ou une requête provenant de l'extérieur de la liste d'autorisation IP de la clé. 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: >- Aucun événement avec cet `event_uuid` n'existe dans l'application : il n'a jamais été enregistré, il a été supprimé ou il appartient à une autre application. Un segment de chemin qui n'est pas un UUID ne correspond pas à la route et renvoie également `404`. content: application/json: examples: Not found: value: detail: No MonitoringEvent matches the given query. '429': description: >- Limite de débit dépassée : les requêtes d'écriture (`POST`, `PATCH`, `DELETE`) partagent un quota de 300 requêtes par minute par clé API. Attendez `Retry-After` secondes, puis réessayez. headers: Retry-After: description: Secondes à attendre avant de réessayer. 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: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.