API Reference

V1

Watchlist

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete Watchlist

v1.watchlist.delete_watchlist(strwatchlist_id) -> object

DELETE/v1/watchlists/{watchlist_id}

Delete a watchlist and all its items

ParametersExpand Collapse

watchlist_id: str

ReturnsExpand Collapse

object

Delete Watchlist

Python

HTTP

TypeScript

Python

Java

Go

CLI Tool

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.watchlist.delete_watchlist(
    "550e8400-e29b-41d4-a716-446655440000",
)
print(response)

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"
  }
}