BRbraiv
Videos

Create a resumable upload session

Creates a 30-minute signed Google Cloud Storage resumable-session URL for a previously reserved upload video. Start the session by POSTing to url with x-goog-resumable: start, then upload bytes using the session URL. Required scope: videos:write.

post/videos/{videoId}/uploads

Request

  • Base URL
    https://api.braiv.co/v1
  • Auth
    • HTTP bearer
    • or API key in header X-Api-Key

Path parameters

videoIdstring required

Braiv library video document ID.

Headers

Idempotency-Keystring

Caller-generated key for safe POST retries. The API retains the first JSON response for 24 hours. Reusing a key with another path or body returns 409 IDEMPOTENCY_REPLAY.

Request body

fileNamestring required

Filename without path separators.

contentTypestring

MIME type applied to the signed upload session.

Response

Signed resumable-upload initiation URL and import job identifier.

urlstring uri required

Signed URL used to initiate the resumable session; expires in 30 minutes.

videoIdstring required

Reserved library video ID.

storagePathstring required

Server-authoritative upload object path.

jobIdstring required

Import job ID to poll after upload.

Changes

No recorded changes to this operation across all 1 revision of this API.