Skip to main content
POST
Start a resumable upload

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

image_id
string
required

Body

application/json
file_size
integer
required

Total size of the image in bytes.

Example:

104857600

Response

Successful Response

The presigned multipart plan: PUT each chunk of the file to its url (in part order), then call /complete — no body needed, the server verifies the uploaded parts with storage directly.

The internal S3 object key is deliberately not exposed: the presigned urls already encode everything the client needs, and the key layout is a server-side implementation detail we keep off the public contract.

upload_id
string
required
part_size
integer
required
urls
PartUrlOut · object[]
required