Lists
Delete a list
Permanently deletes a list. The object’s default list and the last remaining list on an object cannot be deleted. This cannot be undone.
Authorization<token>
API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.
In: header
Path Parameters
workspace*string
The workspace slug — the {slug} segment of your Clarify workspace URL.
object*string
The object type: a built-in entity (person, company, deal, …) or a custom object (c_*).
list*string
The unique ID of the list.
Query Parameters
silent?boolean
When true, suppresses in-app and Slack notifications for this mutation.
Header Parameters
clarify-version?string
The API version for this request. Send 2026-10 to get the behavior documented here. Omit it to use your API key's version, which this header can raise but not lower.
Response Body
application/json
curl -X DELETE "https://example.com/workspaces/string/objects/string/lists/string" \ -H "clarify-version: 2026-10"{}