Probably
Start free
Docs

Get a delivered video's links

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

POST
/api/v1/tools/get_media

Short-lived links to a delivered video and its poster frame: its newest delivery unless versionId names one. The links expire in minutes; share a video for a lasting link.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
videoId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
versionId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
purpose?string
Default"playback"
Value in"playback""download"

Response Body

The tool's answer.

application/json
  1. response
versionId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
url*string
posterUrl*string|null
expiresAt*string
curl -X POST 'https://studio.probably.co/api/v1/tools/get_media' \  -H "Authorization: Bearer $PROBABLY_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "videoId": "3524e86f-1bba-489a-bf6b-386ea1abbac0"}'
{  "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7",  "url": "string",  "posterUrl": "string",  "expiresAt": "string"}