Skip to main content

Delete List

Route​

/v2/lists/{list_id}

Description​

Delete a policy configuration list. This operation permanently removes the list and cannot be undone. Lists that are currently in use by policies cannot be deleted.

Method​

DELETE

Inputs​

ParameterTypeRequiredDescription
list_idstringYesUnique identifier of the list to delete

Path Parameters​

  • list_id: The unique identifier of the list (provided in the URL path)

Request Example​

DELETE /v2/lists/list-123

Output​

FieldTypeDescription
deletedbooleanConfirmation that the list was deleted
list_idstringID of the deleted list

Rate Limit​

  • 60 requests per minute per API key
  • 5 concurrent requests per endpoint

Example Response​

{
  "deleted": true,
  "list_id": "list-123"
}

Usage Notes​

  • Lists that are referenced by active policies cannot be deleted
  • Remove the list from all policies before attempting deletion
  • This operation cannot be undone - consider exporting list values before deletion