Delete named list
Permanently delete a named list and all its items. This action cannot be undone.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Named list identifier |
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:
| Field | Type | Description |
|---|---|---|
message | string | Success confirmation message |
namedList | object | The deleted list data (for reference) |
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
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Named list identifier |
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:
| Field | Type | Description |
|---|---|---|
message | string | Success confirmation message |
namedList | object | The deleted list data (for reference) |
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