Passo Developers
Api

Move a deliverable to another production stage

POST
/deliverables/{deliverableId}/moves

Moves a deliverable to a new production stage and records the move. Stages: script, video, posting, posted (the per-deliverable production axis; the deal's commercial stage is moved separately via /deals/{dealId}/moves). Forward moves (including skips) are allowed and need no reason. A backward move requires a reason. The deliverable is identified by its public id (dlv_…) in the path. Body: toStage and an optional reason. Returns the recorded move. 400 if the move is illegal or a backward move omits a reason; 404 if the deliverable doesn't exist or you can't see it.

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

Path Parameters

deliverableId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/deliverables/string/moves" \  -H "Content-Type: application/json" \  -d '{    "toStage": "script"  }'
{  "id": "string",  "deliverableId": "string",  "fromStage": "script",  "toStage": "script",  "reason": "string",  "actorUserId": "string",  "createdAt": "string"}