Update Watchlist

Updates a watchlist's title and/or description. The list type is immutable — if you send it, it is ignored. Pass description: null to clear the description.

Update watchlist

PUT/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.

Request body

Field	Type	Description
title	string	Optional. New title, non-empty.
description	string	Optional. New description; pass `null` to clear it.

Example request

curl -X PUT "https://api.getsillage.com/api/v2/watchlists/company/128" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Key competitors (EMEA)", "description": "Refocused on EMEA" }'

Example response

{
  "data": {
    "id": 128,
    "kind": "company",
    "type": "competitor",
    "title": "Key competitors (EMEA)",
    "description": "Refocused on EMEA",
    "entity_count": 12,
    "bound_agent_count": 1
  }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The watchlist does not exist in your workspace.
422	Invalid `watchlist_id` or request body.
429	Too many requests.