Passo Developers
Api

List the caller's videos

GET
/videos

Returns the videos in the caller's workspace — each with its current ingest status, review state, version count, and the deliverable it satisfies (deliverable id and public id, null when it names none). The workspace is resolved from the request — an API key uses its own workspace; a user token selects one via the Passo-Workspace header. Optional creatorId and state (in_review, changes_requested, approved) narrow the list. Paginated via limit (default 20, max 100) and offset; total is the unpaginated count.

Authorization

AuthorizationBearer <token>

A Supabase-issued OAuth user access token. On collection endpoints, pair with a Passo-Workspace header to pick a workspace.

In: header

Header Parameters

Passo-Workspace?string

The workspace's public id (e.g. wsp_abc) to operate in. OAuth callers with more than one workspace must send it; a single-workspace caller may omit it. Ignored for API keys (the key is pinned to its workspace). A uuid or another resource's id is rejected with a 400.

Match^wsp_

Response Body

application/json

curl -X GET "https://example.com/videos"
{  "videos": [    {      "id": "string",      "title": "string",      "workspaceId": "string",      "creatorId": "string",      "dealId": "string",      "deliverableId": "string",      "deliverablePublicId": "string",      "jobTitle": "string",      "brandName": "string",      "muxStatus": "preparing",      "state": "in_review",      "playbackId": "string",      "versionCount": -9007199254740991,      "createdAt": "string"    }  ],  "total": -9007199254740991,  "limit": -9007199254740991,  "offset": -9007199254740991}