Delete named list

Permanently delete a named list and all its items. This action cannot be undone.

Path Parameters

Pre-Deletion Checks

Before deleting, the system verifies:

• List exists and belongs to your organization
• List is not referenced by any active policies

Warning: If the list is referenced by active policies, the deletion will fail. Deactivate the list first or remove policy references.

Response

On successful deletion, returns:

Use Cases

• Remove obsolete lists no longer needed
• Clean up test or temporary lists
• Delete lists after policy migration
• Permanently remove deprecated whitelists

Required Permission

lists:delete

Delete named list

Permanently delete a named list and all its items. This action cannot be undone.

Path Parameters

Pre-Deletion Checks

Before deleting, the system verifies:

• List exists and belongs to your organization
• List is not referenced by any active policies

Warning: If the list is referenced by active policies, the deletion will fail. Deactivate the list first or remove policy references.

Response

On successful deletion, returns:

Use Cases

• Remove obsolete lists no longer needed
• Clean up test or temporary lists
• Delete lists after policy migration
• Permanently remove deprecated whitelists

Required Permission

lists:delete