REST API

Delete a people list

Delete one of your people lists (REST and dashboard only; soft-deleted for audit).

DELETE/v1/people-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 people lists (REST and dashboard only; soft-deleted for audit). Subscriptions sinking into it are told by a subscription.invalid event on their next match.

Errors follow one format.