API Reference

V1

Watchlist

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete Watchlist

DELETE/v1/watchlists/{watchlist_id}

Delete a watchlist and all its items

Path ParametersExpand Collapse

watchlist_id: string

Delete Watchlist

HTTP

HTTP

TypeScript

Python

Java

Go

CLI Tool

curl https://api.clearstreet.com/v1/watchlists/$WATCHLIST_ID \
    -X DELETE \
    -H "Authorization: Bearer $API_KEY"

200 example

404 example

{
  "data": null,
  "metadata": {
    "request_id": "cb824f1b-ea6e-4045-8169-9503be2b24d7"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "b8e5824d-391f-448c-a183-9d1582170a1c"
  }
}

Returns Examples

200 example

404 example

{
  "data": null,
  "metadata": {
    "request_id": "cb824f1b-ea6e-4045-8169-9503be2b24d7"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "b8e5824d-391f-448c-a183-9d1582170a1c"
  }
}