Skip to content

Get saved video

One video's save state in the workspace: saved, the workspace's note, and every board holding it with that board's own note and whether its share link is on (shared: anyone with the link sees that note). Read it before replacing a note, taking a video off a board or unsaving, to show what would go. A video that is not saved answers saved: false and no boards. Not the video's library details (Get video). Same answer as the MCP tool get_saved_video. Never counted against the allowance, as its MCP tool; the account still needs a plan (402 no_plan without one).

get/api/v1/saved-videos/{id}

Authentication

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.

Path parameters

Query parameters

  • workspacestring

    Optional: 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

  • videoobject

    With id, url.

  • savedboolean

  • notestring or null

    The workspace's note on the save; null when none.

  • boardsarray of object

    Every board of the workspace holding the video.

  • workspaceobject

    The workspace the request read or changed.

Responses

  • 200

    Whether a video is saved, its notes and its boards. Body: SavedVideoState.

  • 400

    A parameter is malformed or not supported, or workspace is 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

    no_plan: the account has no plan, and the API comes with one. 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.