> ## 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.

# Hapus Event Pemantauan via API

> Didit menghapus permanen satu event pemantauan beserta run aturan, catatan, dan tag-nya. Tindakan ini tidak dapat dibatalkan.

Prompt API untuk Menghapus Event Pemantauan
Salin prompt ke papan klip

<pre>
  \`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.\`
</pre>

Tempel ke

> [!WARNING]
>
> Menghapus event bersifat permanen dan tidak dapat dibatalkan. Untuk menghapus semua data tentang seseorang atau perusahaan, gunakan [hapus pengguna](https://docs.didit.me/id/management-api/users/delete.md) atau [hapus perusahaan](https://docs.didit.me/id/management-api/businesses/delete.md) alih-alih menghapus event mereka satu per satu: tindakan tersebut juga menghapus event mereka.


## OpenAPI

````yaml id/openapi-25.json DELETE /v3/events/{event_uuid}/delete/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/events/{event_uuid}/delete/:
    delete:
      tags:
        - Monitoring Events
      summary: Hapus event pemantauan
      description: >-
        Hapus secara permanen satu event pemantauan beserta eksekusi aturan,
        catatan, dan tautan tag miliknya, misalnya event yang terkirim karena
        kesalahan. Setelah respons `204`, event tersebut hilang dari setiap
        operasi baca (pengambilan data mengembalikan `404`, serta tidak lagi
        muncul dalam daftar atau linimasa subjek), penghapusan ini tidak dapat
        dibatalkan, dan `event_id` miliknya bebas digunakan untuk event baru.
        Tidak terpengaruh: pengguna atau perusahaan yang menjadi rujukan event,
        kasus yang dibuka oleh suatu aturan, entri daftar yang ditambahkan oleh
        suatu aturan, serta skor dan status yang telah diterapkan ke event lain.
        Untuk menghapus semua hal tentang seseorang atau sebuah perusahaan,
        hapus pengguna atau perusahaan tersebut, yang juga akan menghapus event
        mereka. Kunci API dengan cakupan memerlukan `transactions: write`.
      operationId: delete_monitoring_event
      parameters:
        - name: event_uuid
          in: path
          required: true
          description: >-
            Pengidentifikasi Didit untuk event tersebut (`event_uuid` dari
            respons pembuatan, batch, daftar, atau linimasa), bukan `event_id`
            Anda sendiri.
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
      responses:
        '204':
          description: Event telah dihapus. Tanpa body.
        '401':
          description: >-
            Kunci API dengan cakupan terbatas telah kedaluwarsa. Hanya kunci
            yang kedaluwarsa yang menerima `401`; kunci yang hilang atau tidak
            valid menerima `403`.
          content:
            application/json:
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            `x-api-key` tidak ada (kunci yang salah, dicabut, atau kedaluwarsa
            menghasilkan `401`), kunci dengan pembatasan cakupan tanpa
            `transactions: write`, kunci yang dibatasi pada alur kerja tertentu
            atau pada sesi yang disetujui (kunci semacam itu tidak pernah
            mengakses data pemantauan transaksi), atau permintaan dari luar
            allowlist IP milik kunci tersebut.
          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: >-
            Tidak ada event dengan `event_uuid` ini di dalam aplikasi: event
            tidak pernah disimpan, telah dihapus, atau milik aplikasi lain.
            Segmen jalur yang bukan berupa UUID tidak cocok dengan rute dan juga
            mengembalikan `404`.
          content:
            application/json:
              examples:
                Not found:
                  value:
                    detail: No MonitoringEvent matches the given query.
        '429':
          description: >-
            Batas laju terlampaui: permintaan tulis (`POST`, `PATCH`, `DELETE`)
            berbagi anggaran sebanyak 300 permintaan per menit per kunci API.
            Tunggu `Retry-After` detik, lalu coba lagi.
          headers:
            Retry-After:
              description: Detik untuk menunggu sebelum mencoba lagi.
              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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $didit->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: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.