Skip to main content

Complete a video upload

POST 
/api/video/:id/complete-upload

Call after the presigned PUT succeeds. The server checks the object exists in storage, enforces size limits, reads the beginning of the file to confirm it looks like a video, then sets status to processing and queues transcoding. On verification failure the upload may be removed and the video marked failed.

Request​

Path Parameters

    id uuidrequired

    The video ID returned from POST /api/video

Header Parameters

    X-API-KEY stringrequired

    Hyperserve api key

Body

Optional. Send {} or omit when unused. checksum is reserved for future client-side verification.

    checksum string

    Reserved for future client-side integrity verification; omit unless documented otherwise

Responses​

Upload verified; video is processing

Schema

    id uuidrequired

    Video id

    isPublic booleanrequired

    resolutions

    object

    required

    Per-resolution status; all start as processing immediately after complete-upload

    property name*

    object

    status stringrequired

    Possible values: [pending_upload, processing, ready, fail]

Loading...