> ## 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: رفع الحظر > DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/: إزالة عنصر من قائمة حظر أو قائمة سماح أو قائمة مخصصة في Didit. يرفع الحظر عن القوائم النظامية. موجه واجهة API لحذف عنصر من القائمة نسخ الموجّه إلى الحافظة \

\`Remove an entry from a Didit list through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/lists/{list_uuid}/entries/{entry_uuid}/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Remove a single entry from a blocklist, allowlist, or custom list, system lists included.
\- On a system blocklist, removing the entry lifts the block it set: future verifications and transactions are no longer declined for that match.

Path parameters:
\- list_uuid: list UUID from GET /v3/lists/.
\- entry_uuid: entry UUID from GET /v3/lists/{list_uuid}/entries/ or the create response.

Important semantics:
\- Returns 204 No Content with an empty body on success.
\- The entry is deleted: it no longer appears in any read and stops matching. Deletion is irreversible; to list the value again, create a new entry.
\- Calling DELETE again on the same entry_uuid returns 404.
\- Sessions and transactions that already finished are not changed.

Example call:
curl -X DELETE "https://verification.didit.me/v3/lists/{list_uuid}/entries/{entry_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 404: no entry with this UUID in this list, or the list is not in this application ({ "detail": "No ListEntry matches the given query." }).
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- System blocklist entries: the face, document, phone or email record the entry stands for is no longer flagged as blocklisted, so it stops declining new sessions.
\- User and business blocklist entries: every BLOCKED user or business whose vendor_data or UUID matches the entry returns to ACTIVE, whatever blocked it, and not to the status it had before.
\- Face entries: the face stops matching new sessions.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في أزِل عنصراً من قائمة. يُحذف العنصر ويتوقف عن المطابقة فوراً. في قائمة حظر النظام، ترفع Didit أيضاً الحظر الذي فرضه هذا العنصر: لم يعد الوجه أو المستند أو رقم الهاتف أو عنوان البريد الإلكتروني مُدرجاً في قائمة الحظر، ويعود كل مستخدم أو شركة في حالة `BLOCKED` يطابق `vendor_data` الخاص به أو معرّفه UUID أحد عناصر قائمة الحظر من نوع `user` أو `business` إلى الحالة `ACTIVE`، أيًّا كان سبب حظره وأيًّا كانت حالته قبل الحظر. أما الجلسات والمعاملات التي انتهت بالفعل فتحتفظ بحالتها.لرفع الحظر عن الوجه أو المستند أو رقم الهاتف أو عنوان البريد الإلكتروني لجلسة ما في طلب واحد، استخدم [إزالة من قائمة الحظر](https://docs.didit.me/ar/management-api/blocklist/remove.md). ## OpenAPI ````yaml ar/openapi-25.json DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/ 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/lists/{list_uuid}/entries/{entry_uuid}/: delete: tags: - Lists summary: حذف مدخل في القائمة description: >- يحذف مدخلاً واحداً من القائمة، بما في ذلك قوائم النظام. يتوقف المدخل عن المطابقة فوراً، والحذف لا يمكن التراجع عنه: لإدراج القيمة مرة أخرى، أنشئ مدخلاً جديداً. في قائمة الحظر الخاصة بالنظام للوجوه أو المستندات أو أرقام الهواتف أو البريد الإلكتروني، لن يُعلَّم السجل الذي يمثله المدخل بأنه مدرج في قائمة الحظر بعد ذلك؛ وفي قائمة حظر النظام للمستخدمين أو الشركات، يعود مستخدمو أو شركات التطبيق الذين تتطابق `vendor_data` الخاصة بهم مع قيمة المدخل (أو الذين يتطابق `didit_internal_id` الخاص بهم مع `reference_object_uuid` التابع له) وتكون حالتهم `BLOCKED` إلى الحالة `ACTIVE`. تحتفظ الجلسات والمعاملات التي اكتملت بالفعل بحالتها. يتطلب مفتاح API محدد النطاق إذن `workflows: write`. operationId: delete_list_entry parameters: - name: list_uuid in: path required: true description: معرّف UUID للقائمة التي تحتوي على المُدخل. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: entry_uuid in: path required: true description: >- معرّف UUID للمُدخل، كما تم إرجاعه بواسطة سرد مدخلات القائمة أو إنشاء مدخل في القائمة. schema: type: string format: uuid example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee responses: '204': description: تم حذف الإدخال. لا يوجد محتوى استجابة. '401': description: >- انتهت صلاحية مفتاح API محدد النطاق. تُرجع حالات فشل المصادقة الأخرى الرمز `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- رأس `x-api-key` مفقود (المفتاح الخاطئ أو الملغى أو منتهي الصلاحية يحصل على `401`)، أو أن مفتاح API محدد النطاق يفتقر إلى `workflows: 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 workflows access: value: detail: This API key has no write access to workflows. '404': description: >- لا يوجد إدخال بهذا المعرّف UUID في هذه القائمة، أو أن القائمة ليست ضمن التطبيق المرتبط بمفتاح API أو تم حذفها، أو أن الإدخال قد تم حذفه بالفعل. content: application/json: examples: Not found: value: detail: No ListEntry matches the given query. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", ) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); await didit.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", ); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nif err := client.Lists.Entries.Delete(ctx, \"11111111-2222-3333-4444-555555555555\", \"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\"); 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.lists().entries().delete("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"); - lang: php label: PHP source: >- lists->entries->delete('11111111-2222-3333-4444-555555555555', 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" ) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await client.Lists.Entries.DeleteAsync("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"); components: responses: RateLimitedWrite: description: >- تم تجاوز حد الكتابة المشترك البالغ 300 طلب في الدقيقة لكل مفتاح API. التزم بالمدة المحددة في `Retry-After` قبل إعادة المحاولة. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. 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.