Media
Get an upload session
Polls a browser upload session. Once status is completed, files lists the public URLs to pass into a post.
Required permission: `media:read`
Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.
GET
/v1/media/upload-sessions/{id}media:readRequest
Authorization
Send your API key as a Bearer token in the Authorization header.
Path parameters
idstringrequiredUpload session id returned by createMediaUploadSession.
Query parameters
profileIdstringoptionalProfile to act on. Defaults to the profile the API key was created in.
Response
Returns 200.
idstringrequiredstatusenumrequiredOne of:pendingcompletedexpired
uploadUrlstringrequiredMediaUploadSessionFile[]required
expiresAtstringrequiredISO 8601 datetime, for example 2026-08-01T12:00:00Z.
createdAtstringrequiredISO 8601 datetime, for example 2026-08-01T12:00:00Z.
completedAtstringnullablerequiredISO 8601 datetime, for example 2026-08-01T12:00:00Z.
Errors
Failures use the standard error format.
| Status | Code | When it happens |
|---|---|---|
| 401 | invalid_api_key | The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_. |
| 403 | profile_not_accessible | The requested profile is outside this key’s scope, or belongs to another account. |
| 404 | not_found | The resource does not exist inside the resolved profile. |
| 429 | rate_limit_exceeded | Too many requests for this key. Honour the Retry-After header before retrying. |
| 500 | internal_error | Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists. |