List videos
list_videosList videos across your brands, newest first: generated outputs and files added to a Brand Library. Returns each file's media ID, stable link, source, MIME type, size, duration, and Library status.
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_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of matching items to include on this page. Omit to return 20 items. | |
| cursor | No | Pass next_cursor from the previous result to get the next page. | |
| source | No | Filter by how the file was obtained: uploaded for uploaded files, scraped for files collected from brand sources, or generated for model outputs. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| in_library | No | Only files in (true) or not in (false) the Library. | |
| brand_session_id | No | Brand whose videos to retrieve. Use its Brand session ID from list_brands; omit to leave results unfiltered by brand. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Matching files, newest first. | |
| has_more | Yes | Whether more results follow this page. | |
| next_cursor | Yes | Pass as cursor to get the next page. Null when no more results follow. |