Skip to main content

Create a resumable upload

POST 
/api/v1/orgs/{orgId}/ai-models/{modelId}/editions/{edition}/uploads

Creates a new resumable upload session — step 2 of the resumable upload flow.

• Call Register New Edition first to obtain an uploadId, then send it (base64-encoded) in the Upload-Metadata header.

• Service will validate the uploadId, and that Upload-Length matches the registered file size.

• On success the Location header points to the upload resource URL used for the subsequent PATCH requests.

• The uploadId never expires: after a terminated (DELETE) or failed transfer, call this endpoint again with the same uploadId to retry from scratch. An in-progress session blocks re-creation only until its uploadExpiresAt passes — after that it is considered abandoned, and re-creating discards the stalled transfer's data and starts over. An already-uploaded session can never be re-created.

• Returns 400 if the backend pre-create hook rejects the request (missing / completed / still-fresh in-progress upload, size mismatch).

Request​

Responses​

Upload created. The Location header contains the upload resource URL.

Response Headers
    Location

    URL of the created upload resource.

    Tus-Resumable

    TUS protocol version.