Docs / Delete a watchlist

Delete a watchlist

Last updated 2026-11-13

Delete a watchlist.

DELETE/v1/watchlists/{id} · API key required

Deletes the watchlist and its values. The webhook is kept.

Parameters

Name	In	Required	Description
`id`	path	yes	The watchlist id, such as wl_8c1d2e3f4a5b. Example: `wl_8c1d2e3f4a5b`

Request

curlJavaScriptPython

curl -X DELETE https://recalldb.app/v1/watchlists/wl_8c1d2e3f4a5b \
  -H "Authorization: Bearer $RECALLDB_KEY"

const res = await fetch('https://recalldb.app/v1/watchlists/wl_8c1d2e3f4a5b', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.RECALLDB_KEY}` },
})
console.log(await res.json())

import os, requests

r = requests.delete("https://recalldb.app/v1/watchlists/wl_8c1d2e3f4a5b", headers={"Authorization": f"Bearer {os.environ['RECALLDB_KEY']}"})
r.raise_for_status()
body = r.json()
print(body)

Response

200 OK

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

Every response includes source (agency, official ID, official URL, last updated) and attribution. Attribution rules.

Notes

Counts as one request.

Errors: error codes. Limits: rate limits.