> ## 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. # Elimina evento di monitoraggio API > Didit elimina in modo definitivo un evento di monitoraggio con regole, note e tag. Non compare più in nessuna lettura: l'azione è irreversibile. Prompt API per eliminare l'evento di monitoraggio Copia il prompt negli appunti 
  \`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.\`
Incolla in > [!WARNING] > > L'eliminazione di un evento è irreversibile. Per cancellare tutti i dati relativi a una persona o a un'azienda, [elimina l'utente](https://docs.didit.me/it/management-api/users/delete.md) o [elimina l'azienda](https://docs.didit.me/it/management-api/businesses/delete.md) invece di eliminare i loro eventi uno alla volta: così vengono eliminati anche i loro eventi. ## OpenAPI ````yaml it/openapi-25.json DELETE /v3/events/{event_uuid}/delete/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/{event_uuid}/delete/: delete: tags: - Monitoring Events summary: Elimina evento di monitoraggio description: >- Elimina definitivamente un evento di monitoraggio insieme alle relative esecuzioni delle regole, note e collegamenti ai tag, ad esempio un evento inviato per errore. Dopo il `204` l'evento non è più presente in alcuna operazione di lettura (il recupero restituisce `404` e non compare più nell'elenco o nella cronologia del soggetto), l'eliminazione è irreversibile e il suo `event_id` può essere riutilizzato per un nuovo evento. Non sono interessati: l'utente o l'azienda a cui l'evento è stato associato, i casi aperti da una regola, le voci di elenco aggiunte da una regola e i punteggi e gli stati già applicati ad altri eventi. Per cancellare tutto ciò che riguarda una persona o un'azienda, elimina invece l'utente o l'azienda, eliminando così anche i relativi eventi. Una chiave API con ambito limitato richiede `transactions: write`. operationId: delete_monitoring_event parameters: - name: event_uuid in: path required: true description: >- Identificatore Didit dell'evento (`event_uuid` dalla risposta di creazione, batch, elenco o timeline), non il tuo `event_id`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: L'evento è stato eliminato. Nessun payload. '401': description: >- La chiave API con ambito è scaduta. Solo una chiave scaduta riceve `401`; una chiave mancante o non valida riceve `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Intestazione `x-api-key` mancante (una chiave errata, revocata o scaduta restituisce `401`), una chiave con ambito priva di `transactions: write`, una chiave limitata ad alcuni workflow o a sessioni approvate (tale chiave non accede mai ai dati di monitoraggio delle transazioni), oppure una richiesta proveniente dall'esterno dell'allowlist IP della chiave. 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: >- Nessun evento con questo `event_uuid` esiste nell'applicazione: non è mai stato memorizzato, è stato eliminato o appartiene a un'altra applicazione. Un segmento di percorso che non sia un UUID non corrisponde alla route e restituisce anch'esso `404`. content: application/json: examples: Not found: value: detail: No MonitoringEvent matches the given query. '429': description: >- Limite di frequenza superato: le richieste di scrittura (`POST`, `PATCH`, `DELETE`) condividono un budget di 300 richieste al minuto per chiave API. Attendi `Retry-After` secondi, quindi riprova. headers: Retry-After: description: Secondi da attendere prima di effettuare un nuovo tentativo. 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 chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.