> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allocait.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Watchlist tools

> List, save and delete watchlists.

Three tools keep watchlists. Call `list_watchlists` before you change one, or to see which lists a playbook, monitor or chart can draw its symbols from.

**list\_watchlists** `read`

Your watchlists with their symbols in order. Use it before you change a watchlist, or to see which lists a playbook, monitor or chart can draw its symbols from. Key arguments: optional `watchlist_id`.

**save\_watchlist** `write, destructive`

Creates a watchlist, renames it, or changes its symbols. `add` appends and `remove` drops; `items` sets the whole list in order, and symbols it leaves out must be named in `remove`. Send `items` or `add`, not both. A symbol sent without a class is filed from the catalog. A symbol sent with `label: true` is a name for your research and is never filed, classed or priced; `list_watchlists` marks it `label: true`. Items can be a symbol or an object with `symbol`, optional `asset_class` and `label`. Returns what was added and removed. Key arguments: `watchlist_id` (to change one), `name`, `items` (up to 200), `add`, `remove`.

**delete\_watchlist** `write, destructive`

Deletes a watchlist. Playbooks, monitors and charts that drew symbols from it lose that source, and the result names them. Key arguments: `watchlist_id`.

## Next steps

> [card] [Labels](https://docs.allocait.app/concepts/labels.md)
>
> A name you keep research under that Allocait never prices or holds.

> [card] [Watchlists and charts](https://docs.allocait.app/concepts/watchlists-and-charts.md)
>
> Group symbols to follow and chart the values you record.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.