Delete List

Deletes a list and its membership links (the canonical companies/people are shared and never deleted). A list that is still bound to one or more agents cannot be deleted — unbind it first (see Update agent, pass both watchlist_kind: null and watchlist_id: null).

Delete list

DELETE/api/v2/partner/workspaces/{partner_workspace_id}/lists/{kind}/{list_id}

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.
kind	string	List kind: `company` or `profile` (matches the list type).
list_id	integer	Identifier of the list.

Example request

curl -X DELETE "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/lists/company/128" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": { "id": 128 }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The list does not exist in your workspace.
409	The list is bound to one or more agents; unbind them first.
422	Invalid `list_id` — must be a positive integer.
429	Too many requests.