v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-028581251.8 KB

place.stream.media

Start a resumable upload of arbitrary media content. Returns a TUS upload URL and a short-lived bearer token used to authenticate subsequent chunk requests (no DPoP required on chunks). The DID of the authenticated user is recorded against the upload; on completion a VOD processing task is enqueued.

post/xrpc/place.stream.media.createUpload

Request body

sizeinteger required

Total size of the upload in bytes.

mimeTypestring required

MIME type of the content being uploaded (e.g. video/mp4).

filenamestring

Optional filename hint to attach as upload metadata.

draftUristring

Optional ats:// URI of a draft VOD created via place.stream.vod.createDraft. When supplied, the upload's processing fills that draft (rather than creating a new one), so the user can edit metadata while the upload runs and re-upload if it fails. The draft's origin_upload_id is set to this upload.

Response

Success

uploadIdstring required

Server-side identifier for this upload.

uploadUrlstring uri required

Absolute URL to PATCH/HEAD per the TUS protocol.

uploadTokenstring required

Short-lived bearer token bound to this upload. Send as 'Authorization: Bearer <token>' on TUS requests.

expiresAtstring date-time required

When the upload token expires.