> ## 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 لحذف حدث المراقبة نسخ الموجّه إلى الحافظة 
  \`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.\`
الصق في > [!WARNING] > > لا يمكن التراجع عن حذف الحدث. لمحو كل ما يتعلق بشخص أو شركة، استخدم [حذف المستخدم](https://docs.didit.me/ar/management-api/users/delete.md) أو [حذف الشركة](https://docs.didit.me/ar/management-api/businesses/delete.md) بدلاً من حذف أحداثهم واحداً تلو الآخر، فهذا يحذف أحداثهم أيضاً. ## OpenAPI ````yaml ar/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: >- معرّف Didit للحدث (`event_uuid` من استجابة الإنشاء أو الدُفعة أو القائمة أو المخطط الزمني)، وليس `event_id` الخاص بك. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: تم حذف الحدث. لا يوجد نص استجابة (body). '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`، أو مفتاح مقتصر على بعض مسارات سير العمل أو على الجلسات المقبولة (مثل هذا المفتاح لا يصل أبداً إلى بيانات مراقبة المعاملات)، أو طلب من خارج قائمة العناوين المسموح بها للمفتاح. 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`) رصيداً قدره 300 طلب في الدقيقة لكل مفتاح API. انتظر لعدد الثواني المحدد في `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: >- 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: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.