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, and version count. 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, rejected) 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 id (uuid) 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).

Formatuuid

Response Body

application/json

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