List assets
list_assetsList assets in a Playbook workspace, optionally filtered to a specific board. Set nested_assets with a board token to include its entire subtree. Use cursor pagination for a stable full crawl/reconcile; it is not a change feed and does not report deletions. For 'what is new in this board since X', pass created_after with collection_token and nested_assets. Signed display URLs expire after about 24 hours; store permalink when a permanent URL is required. Set uploaded_by to list everything one person added — prefer this over the search tools when you want a COMPLETE list, since it walks the database directly and is not subject to the search engine's result ceiling. Resolve the person with list_members first.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_assets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-indexed) | |
| cursor | No | Use stable cursor pagination for a full crawl instead of page numbers | |
| fields | No | Return ONLY these fields on each row. `token` is always included. Valid names: token, title, media_type, text_type, status, approved, approved_after, tags, permalink, display_url, stream_url, collection_token, size, is_skeleton, uploaded_by, source_error, ai_generated, ai_agent_payload. Use it when scanning a large board: `display_url` and `permalink` are ~400 characters each, so a 100-row page is mostly URL unless you narrow it. An unknown name is refused, not ignored: there is no `created_at`, `updated_at`, `width` or `height` among them, and an asset's dimensions come from get_asset or get_assets instead. | |
| per_page | No | Items per page (1-100, default 20) | |
| uploaded_by | No | List only assets uploaded by this person. Pass a member token from list_members. A name is accepted as a fallback and resolved server-side, but only when it matches exactly one member — otherwise the call fails and lists the candidates. One person per call; use search_assets or ai_search to filter by several at once. | |
| after_cursor | No | Opaque cursor returned by the previous cursor-paginated response | |
| organization | No | Workspace slug, as returned by list_organizations. Omit it when the account has a single workspace — it is then resolved from your token. Pass it only when the account has several, or when you mean a workspace other than the obvious one. | |
| created_after | No | Only assets uploaded strictly after this ISO 8601 timestamp or date (a bare date is midnight UTC). Sees NEW uploads only: an asset edited, retagged or moved into the board later keeps its original upload time and is not returned, and neither is an upload that auto-grouping stacked into a group that already existed. An unparseable value is refused. | |
| nested_assets | No | Include assets from the board's entire nested subtree. Requires `collection_token` — on its own, with no board token, it is refused. | |
| get_ai_payload | No | Include each asset's `ai_agent_payload` on the rows. Default false, and the key is then ABSENT rather than null, so you can tell 'I did not ask' from 'nothing is stored'. Each payload can be up to 4 KB, so a full page with this on is a large response — ask for it when you actually need the context, not by default. get_asset always returns it. | |
| collection_token | No | Board token to filter by — the parameter name is `collection_token`, not `board_token`. Take the token from list_boards, list_board_children or ai_search: the id in a shared board link, a published page URL or a permalink is a different identifier, and passing one here fails the same way as a token from another workspace. A share link goes through resolve_share_link first, which returns the board token. |