Remove Entity

Removes a single member from a watchlist by its entity id (the id returned by List entities or Add entities). Only the membership link is removed — the canonical company/profile is shared and never deleted. Returns 404 when the entity is not a member of this list.

Remove entity

DELETE/api/v2/watchlists/{kind}/{watchlist_id}/entities/{entity_id}

Path parameters

Parameter	Type	Description
kind	string	Watchlist kind: `company` or `profile` (matches the list type).
watchlist_id	integer	Identifier of the watchlist.
entity_id	integer	Identifier of the member (canonical company/profile id).

Example request

curl -X DELETE "https://api.getsillage.com/api/v2/watchlists/company/128/entities/901" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

const response = await fetch(
  'https://api.getsillage.com/api/v2/watchlists/company/128/entities/901',
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.SILLAGE_API_KEY}` },
  },
)

const result = await response.json()

import { request } from 'node:https'

const req = request(
  new URL('https://api.getsillage.com/api/v2/watchlists/company/128/entities/901'),
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.SILLAGE_API_KEY}` },
  },
  (res) => {
    let data = ''
    res.on('data', (chunk) => {
      data += chunk
    })
    res.on('end', () => {
      console.log(JSON.parse(data))
    })
  },
)

req.end()

import os
import requests

response = requests.delete(
    "https://api.getsillage.com/api/v2/watchlists/company/128/entities/901",
    headers={"Authorization": f"Bearer {os.environ['SILLAGE_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
result = response.json()

Example response

{
  "data": { "id": 901, "deleted": true }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The watchlist or the entity-on-list was not found.
422	Invalid path parameters.
429	Too many requests.