CueFrame
Api

Read a hosted review packet (token-authenticated page data)

The checkpoint page's data: stage artifact (rendered from the packet's own snapshot), presigned stills, critic verdicts, the money triple, the recorded decision once resolved, and the run's v1→vN version stack. Authenticated by the packet's reviewToken (?token=) — the URL from the checkpoint.ready webhook / get_checkpoint. Expired or already-answered packets still render (with their decision), never an error page.

GET
/v1/review/{id}

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/review/string"
{  "id": "string",  "projectId": "string",  "composeJobId": "string",  "briefId": "string",  "kind": "gate",  "stage": "content",  "version": 0,  "status": "awaiting",  "artifact": null,  "stillUrls": [    "string"  ],  "criticVerdicts": null,  "quote": {    "thisStepUsd": 0,    "jobSpendSoFarUsd": 0,    "estimatedJourneyTotalUsd": 0  },  "revisionCycle": 0,  "decision": null,  "reviewMode": "agent",  "createdAt": 0,  "updatedAt": 0,  "versionStack": [    {      "id": "string",      "version": 0,      "stage": "content",      "status": "string",      "decision": "string",      "createdAt": 0    }  ]}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

Get a checkpoint packet GET

The full approval packet: the stage artifact under review, presigned storyboard/eval stills, critic verdicts (incl. lock_violation entries), the money triple {thisStep, jobSpendSoFar, estimatedJourneyTotal}, and the recorded decision once resolved. Answer an `awaiting` packet with POST /v1/checkpoints/{id}/resume.

List checkpoints (scope to a compose job or project) GET

The version stack of approval packets, newest first. Scope with ?composeJobId= to see one run's gate history (v1→vN with per-version status + decisions) or ?projectId= for everything reviewable in a project.