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

\`Delete an allowlist or custom list from my Didit application through the Management API.

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

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

Goal:
\- Delete an allowlist or custom list that I no longer need, together with its entries.
\- System lists (is_system: true) cannot be deleted; the API answers 400.

Path parameter:
\- list_uuid: the list UUID returned by GET /v3/lists/ or POST /v3/lists/.

Important semantics:
\- Returns 204 No Content with an empty body on success.
\- The list no longer appears in any read and its entries can no longer be listed.
\- Workflow and transaction rule conditions that reference the list (value_type: "list") evaluate it as an empty list from then on. Audit them before deleting.
\- Deletion is irreversible. The name can be reused for a new list.
\- Calling DELETE again on the same list_uuid returns 404.

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

Failure modes:
\- 400: the list is a system list ({ "detail": "System lists cannot be deleted." }).
\- 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 list with this UUID in this application, or it was already deleted.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- The list and its entries are deleted.

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

\
الصق في احذف قائمة السماح أو القائمة المخصصة مع إدخالاتها. لم تعد القائمة تظهر في أي عملية قراءة، وتقيّم شروط سير العمل وقواعد المعاملات التي تشير إليها على أنها قائمة فارغة. لا يمكن التراجع عن الحذف.لا يمكن حذف القوائم النظامية (قوائم الحظر، وقائمة **High Risk Countries**، وقوائم السماح النظامية)، وتعيد الطلبات الموجهة إليها الاستجابة `400`. لإفراغ قائمة نظامية، [احذف إدخالاتها](https://docs.didit.me/ar/management-api/lists/delete-entry.md) واحدًا تلو الآخر. ## OpenAPI ````yaml ar/openapi-25.json DELETE /v3/lists/{list_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}/: delete: tags: - Lists summary: حذف قائمة description: >- يحذف قائمة سماح أو قائمة مخصصة جنباً إلى جنب مع مدخلاتها. الحذف لا يمكن التراجع عنه: لن تظهر القائمة ومدخلاتها بعد ذلك في أي عملية قراءة، كما أن شروط قواعد سير العمل والمعاملات التي تشير إلى القائمة ستعتبرها قائمة فارغة من ذلك الحين فصاعداً. تحتفظ الجلسات والمعاملات التي تم تقييمها بالفعل بنتائجها، ويمكن إعادة استخدام الاسم لقائمة جديدة. لا يمكن حذف قوائم النظام وتعيد الرمز `400`؛ لإفراغ إحداها، [احذف مدخلاتها](https://docs.didit.me/ar/management-api/lists/delete-entry). يتطلب مفتاح API محدد النطاق إذن `workflows: write`. operationId: delete_list parameters: - name: list_uuid in: path required: true description: معرّف UUID للقائمة، كما تم إرجاعه بواسطة سرد القوائم أو إنشاء قائمة. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: تم حذف القائمة ومدخلاتها. لا يوجد نص استجابة. '400': description: القائمة هي قائمة نظام. content: application/json: examples: System list: value: detail: System lists cannot be deleted. '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 List 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/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.lists.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.lists.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.Lists.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.lists().delete("11111111-2222-3333-4444-555555555555"); - lang: php label: PHP source: |- lists->delete('11111111-2222-3333-4444-555555555555'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.lists.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.Lists.DeleteAsync("11111111-2222-3333-4444-555555555555"); 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.