Changelog

Every change to the public contract is recorded here. Entries track the committed API spec and MCP tool inventory, so this page cannot drift from what the surface actually does — a change to an endpoint or a tool lands in the same change as its entry below.

Read Conventions → Versioning for what counts as breaking, and how deprecations are announced before anything is removed.

v1 — Initial surface

The first version of the Passo developer surface.

MCP server

The remote MCP server is public at /v1/mcp, with a read-only variant at /v1/mcp/readonly. Authentication is OAuth 2.1 with dynamic client registration; an agent acts as the user who authorised it. Tools in this version:

• whoami — the connected user's profile.
• list_workspaces — the workspaces the user belongs to.
• list_my_videos — the videos the user can see, newest first.
• list_videos_awaiting_review — the review queue: videos whose current cut is in_review.
• get_video_review — a single video and its full version history.

See the tools reference for inputs and example results.

REST API

The REST API is built and documented, and published on request. This version covers workspaces and membership (/me, /workspaces, workspace members and invites) and the creator-video domain (jobs, deals, videos). See the API reference for every endpoint.

Conventions established

• Clamped pagination (limit default 20, max 100; offset; total in every list response).
• HTTP status codes with a code / message body for REST; structured { error } results for MCP tools.
• Path versioning (/v1, /v1/mcp); additive changes are non-breaking.