Delete Watchlist
Delete a watchlist that is not bound to any agent.
Deletes a watchlist 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 watchlist
DELETE/api/v2/watchlists/{kind}/{watchlist_id}
Path parameters
| Parameter | Type | Description |
|---|---|---|
| kind | string | Watchlist kind: company or profile (matches the list type). |
| watchlist_id | integer | Identifier of the watchlist. |
Example request
curl -X DELETE "https://api.getsillage.com/api/v2/watchlists/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 watchlist does not exist in your workspace. |
| 409 | The watchlist is bound to one or more agents; unbind them first. |
| 422 | Invalid watchlist_id — must be a positive integer. |
| 429 | Too many requests. |