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

# 모니터링 이벤트 삭제 API

> Didit에서 모니터링 이벤트 하나를 규칙 실행 기록, 메모, 태그와 함께 영구 삭제합니다. 삭제 후 모든 조회에서 사라지며 되돌릴 수 없습니다.

모니터링 이벤트 삭제 API 프롬프트
프롬프트를 클립보드에 복사

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

붙여넣을 곳

> [!WARNING]
>
> 이벤트를 삭제하면 되돌릴 수 없습니다. 개인 또는 기업과 관련된 모든 정보를 지우려면, 이벤트를 하나씩 삭제하는 대신 [사용자 삭제](https://docs.didit.me/ko/management-api/users/delete.md) 또는 [기업 삭제](https://docs.didit.me/ko/management-api/businesses/delete.md)를 이용하십시오. 이 작업으로 해당 사용자나 기업의 이벤트도 함께 삭제됩니다.


## OpenAPI

````yaml ko/openapi-25.json DELETE /v3/events/{event_uuid}/delete/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/events/{event_uuid}/delete/:
    delete:
      tags:
        - Monitoring Events
      summary: 모니터링 이벤트 삭제
      description: >-
        실수로 전송된 이벤트 등 모니터링 이벤트 하나를 해당 규칙 실행 기록, 메모, 태그 링크와 함께 영구적으로 삭제합니다. `204`
        응답 후에는 모든 조회에서 해당 이벤트가 사라지며(조회 시 `404` 반환, 목록이나 대상 타임라인에 더 이상 표시되지 않음),
        삭제는 되돌릴 수 없고 해당 `event_id`는 새 이벤트에 다시 사용할 수 있습니다. 영향을 받지 않는 항목: 이벤트가
        연결되었던 사용자 또는 기업, 규칙에 의해 생성된 케이스, 규칙에 의해 추가된 목록 항목, 다른 이벤트에 이미 적용된 점수 및
        상태. 개인이나 기업에 관한 모든 정보를 삭제하려면 사용자 또는 기업을 대신 삭제하십시오. 해당 이벤트도 함께 삭제됩니다.
        스코프가 지정된 API 키에는 `transactions: write` 권한이 필요합니다.
      operationId: delete_monitoring_event
      parameters:
        - name: event_uuid
          in: path
          required: true
          description: >-
            자체 `event_id`가 아닌 이벤트의 Didit 식별자(생성, 일괄 처리, 목록 또는 타임라인 응답의
            `event_uuid`)입니다.
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
      responses:
        '204':
          description: 이벤트가 삭제되었습니다. 본문이 없습니다.
        '401':
          description: >-
            스코프가 지정된 API 키가 만료되었습니다. 만료된 키에 대해서만 `401`이 반환되며, 누락되었거나 유효하지 않은 키에는
            `403`이 반환됩니다.
          content:
            application/json:
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            `x-api-key`가 누락되었거나(잘못되었거나 취소되었거나 만료된 키에는 `401`이 반환됨),
            `transactions: write` 권한이 없는 범위 제한 키이거나, 특정 워크플로 또는 승인된 세션으로 제한된
            키이거나(이러한 키는 거래 모니터링 데이터에 절대 접근할 수 없음), 키의 IP 허용 목록 외부에서 발생한 요청입니다.
          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: >-
            애플리케이션에 이 `event_uuid`를 가진 이벤트가 존재하지 않습니다. 저장된 적이 없거나, 삭제되었거나, 다른
            애플리케이션에 속해 있습니다. UUID가 아닌 경로 세그먼트는 라우트와 일치하지 않아 마찬가지로 `404`를 반환합니다.
          content:
            application/json:
              examples:
                Not found:
                  value:
                    detail: No MonitoringEvent matches the given query.
        '429':
          description: >-
            속도 제한 초과: 쓰기 요청(`POST`, `PATCH`, `DELETE`)은 API 키당 분당 300개의 요청 한도를
            공유합니다. `Retry-After`초 동안 대기한 후 재시도하세요.
          headers:
            Retry-After:
              description: 재시도하기 전 대기할 시간(초)입니다.
              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: >-
        Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본
        키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며
        특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나
        만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된
        IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를
        벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write
        권한이 없는 키는 세션 링크와 token을 null로 수신합니다.
        https://docs.didit.me/console/api-keys 를 참고하십시오.

````

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