Skip to main content
DELETE
curl
Delete an allowlist or custom list together with its entries. The list no longer appears in any read, and workflow and transaction rule conditions that reference it evaluate it as an empty list. Deletion is irreversible. System lists (blocklists, the High Risk Countries list and system allowlists) cannot be deleted and return 400. To empty a system list, delete its entries one by one.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

list_uuid
string<uuid>
required

UUID of the list, as returned by List lists or Create a list.

Response

The list and its entries were deleted. No body.