Get an upload
One upload (obj_…). There is no separate processing state: uploaded turns true on POST /uploads//complete (or when an import finishes), and the media’s facts (duration, width, height, fps, hasVideo, hasAudio) arrive a few seconds to about half a minute later; they are null until then. A playlist takes the upload as soon as uploaded is true; publishing a live playlist waits up to 40 s for a video’s width and height (else 422 METADATA_PENDING, retry). An import shows its progress in externalSource.state; externalSource is null for a direct upload.
Authorizations
OAuth 2.1 authorization-code flow with PKCE.
Headers
Workspace this request operates in — the workspace id (wksp_…) or the organization id, from GET /workspaces. Required with an API key, which carries no workspace (400 WORKSPACE_REQUIRED without it). With an OAuth token it defaults to the workspace the token was issued for. Responds 403 WORKSPACE_FORBIDDEN when the caller is not a current member, rather than falling back to another workspace.
Path Parameters
Resource identifier.
Response
Successful response.
audio, video, image