Clarify API
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.

DELETE
/workspaces/{workspace}/objects/{object}/lists/{list}
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.

Response Body

application/json

curl -X DELETE "https://example.com/workspaces/string/objects/string/lists/string"
{}