> ## 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 Daftar API: Hapus Daftar Kepatuhan > DELETE /v3/lists/{list_uuid}/: hapus allowlist atau daftar kustom dan entri-entrinya dari aplikasi Didit Anda. Daftar sistem tidak dapat dihapus. Prompt API Hapus Daftar Salin prompt ke papan klip \

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

\
Tempel ke Hapus allowlist atau daftar kustom beserta entri-entrinya. Daftar tersebut tidak lagi muncul dalam operasi baca mana pun. Kondisi alur kerja dan aturan transaksi yang merujuk ke daftar tersebut menganggapnya sebagai daftar kosong. Penghapusan tidak dapat dibatalkan.Daftar sistem (daftar blokir, daftar **High Risk Countries**, dan allowlist sistem) tidak dapat dihapus dan akan mengembalikan `400`. Untuk mengosongkan daftar sistem, [hapus entrinya](https://docs.didit.me/id/management-api/lists/delete-entry.md) satu per satu. ## OpenAPI ````yaml id/openapi-25.json DELETE /v3/lists/{list_uuid}/ 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/lists/{list_uuid}/: delete: tags: - Lists summary: Hapus daftar description: >- Menghapus daftar izin (allowlist) atau daftar kustom beserta entri-entrinya. Penghapusan tidak dapat dibatalkan: daftar dan entrinya tidak lagi muncul dalam respons pembacaan apa pun, dan kondisi aturan alur kerja dan aturan transaksi yang merujuk pada daftar tersebut akan mengevaluasinya sebagai daftar kosong sejak saat itu. Sesi dan transaksi yang telah dievaluasi tetap mempertahankan hasilnya, dan nama tersebut dapat digunakan kembali untuk daftar baru. Daftar sistem tidak dapat dihapus dan mengembalikan `400`; untuk mengosongkannya, [hapus entri-entrinya](https://docs.didit.me/id/management-api/lists/delete-entry). Kunci API dengan cakupan membutuhkan `workflows: write`. operationId: delete_list parameters: - name: list_uuid in: path required: true description: >- UUID daftar, seperti yang dikembalikan oleh Cantumkan daftar atau Buat daftar. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: Daftar dan entri di dalamnya telah dihapus. Tidak ada isi respons. '400': description: Daftar ini adalah daftar sistem. content: application/json: examples: System list: value: detail: System lists cannot be deleted. '401': description: >- Kunci API dengan cakupan terbatas telah kedaluwarsa. Kegagalan autentikasi lainnya mengembalikan `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Header `x-api-key` tidak ada (kunci yang salah, dicabut, atau kedaluwarsa menghasilkan `401`), atau kunci API dengan cakupan tertentu tidak memiliki `workflows: write` atau digunakan dari alamat IP di luar daftar izinnya. 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: >- Tidak ada daftar dengan UUID ini di aplikasi milik kunci API, atau daftar tersebut sudah dihapus. 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: >- Batas tulis bersama sebesar 300 permintaan per menit per kunci API telah terlampaui. Patuhi `Retry-After` sebelum mencoba lagi. 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: >- 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.