List slideshow runs
list_slideshow_runsBrowse and filter owner-scoped slideshow runs by platform, status, brand, or search query, then retrieve a runId for inspection, updates, or archiving.
Instructions
List owner-scoped Slideshow Runs with optional platform, lifecycle status, or search query filters. Returns run metadata, platform target, page counts, revision numbers, and timestamps. Call to browse existing carousels or find a runId before inspection, updating, or archiving. Alternatives: Use get_slideshow_run when you already have a specific runId to fetch full slide content. Behavior: Read-only query scoped to current authenticated workspace owner.
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_slideshow_runs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search term matching run title, topic, or content text. | |
| status | No | Lifecycle status filter: draft | active | archived | trash | |
| brandId | No | Filter runs styled with a specific Brand ID. | |
| platform | No | Target platform filter: tiktok | linkedin | instagram | threads | xiaohongshu | x | |
| profileId | No | Optional profile filter. | |
| contentSlug | No | Filter runs generated from a specific content topic slug. | |
| brandProfileId | No | Optional legacy brand profile filter. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runs | No | Array of slideshow run summary items. | |
| total | No | Total count of matching runs. |