lists
Delete a static List
DELETE /v1/lists/{id}
Auth required
api.lists.manage
Deletes a managed List definition. On writes, {id} resolves as a UUID
or, failing that, as the List's org-unique key. Git-backed Lists are
read-only here (409 conflict) — the sync owns them, and removing the
key from the repo archives (never deletes) the List. The ClickHouse
membership log is left in place (harmless once the definition is gone).
Path parameters
id string required The List's UUID or, when the value does not parse as a UUID, its org-unique key. Unknown handles read as 404 not_found.
Responses
204 List deleted (no content)
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
409 The mutation is rejected by a state rule rather than a bad request — e.g.
editing a git-backed (read-only) definition. The
code is conflict.
application/problem+json 429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json