Probably
Start free
Docs

Read a video's cut

read_composition, in Reads: Any connection or key may call these.

POST
/api/v1/tools/read_composition

Read a delivered video's cut, on its main line or the variant line names: its version, its manifest (the clip IDs patch_composition's edits name) and a plain timeline of what's on screen when, with any problems. Change it with patch_composition at this version; see it with preview_frame. A video that isn't delivered yet has no cut to read.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (prb_…) from Settings → Connections.

Request Body

application/json
  1. body
videoId*string
Formatuuid
line?string
Formatuuid

Response Body

The tool's answer.

application/json
  1. response
compositionId*string
Formatuuid
version*integer
Range0 < value <= 9007199254740991
manifest*

The cut as stored: its tracks and clips, whose IDs the edits name.

timeline*

What's on screen when, by track and clip, with any problems, in plain words.

curl -X POST 'https://probably.co/api/v1/tools/read_composition' \  -H "Authorization: Bearer $PROBABLY_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "videoId": "3524e86f-1bba-489a-bf6b-386ea1abbac0"}'
{  "compositionId": "029ddfe7-7740-40bd-98d7-6bf1dddf345e",  "version": 1,  "manifest": {    "property1": null,    "property2": null  },  "timeline": {    "property1": null,    "property2": null  }}