Skip to Content
API & MCPDELDelete a list

Lists & exclusions

Delete a list

Delete one of your lists (REST and dashboard only).

DELETE/v1/lists/:list_id
REST only — not an MCP toolscope lists:writeNo record cost

Parameters

list_idstringrequired

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Delete one of your lists (REST and dashboard only). It stops applying immediately; the rows are kept soft-deleted for audit.

Errors follow one format.