List saved videos
The videos saved in the workspace, newest save first, each as a card with the workspace's note on it (null when none). Page with offset and the answer's next_offset. A workspace with no saves answers an empty list. Same answer as the MCP tool list_saved_videos. Each request counts against the team's call allowance, shared with MCP; past it, a 402.
/api/v1/saved-videosAuthentication
OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.
Query parameters
limitintegerHow many, 1 to 100. Default
20.offsetintegerThe previous page's next_offset; null there means there is no further page. Default
0.workspacestringOptional: the workspace's id or exact name, from List workspaces. Without it, the current workspace (the one the account last opened in the app). Every answer names the workspace it acted in. 1 to 120 characters.
Response fields
videosarray of anynext_offsetinteger or nullPass as offset for the next page; null when there is none.
notestringWhen the list stops early, why.
workspaceobjectThe workspace the request read or changed.
Responses
- 200
A workspace's saved videos and their notes. Body:
SavedVideoList. - 400
A parameter is malformed or not supported, or
workspaceis empty, repeated or too long. Body:Problem. - 401
No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body:
Problem. - 402
The team's call allowance is used up (
quota_exceeded), or the account has no plan and so no calls (no_plan), or an account with no plan asked past a list's first page (plan_limit);resolutionsays what to do and links the plans page. Body:Problem. - 403
The token lacks mcp:read.
workspace_locked: the workspace is past the plan's workspaces, so nothing was read or changed; use an open one (List workspaces marks the locked ones). Body:Problem. - 404
No such niche, format, brand, creator, page or endpoint.
workspace_not_found: the organization has no workspace with that id or name (List workspaces lists them). Body:Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.