Sign in

v2

latestOpenAPI 3.1.02026-08-06276982.8 KB
batches

Start multipart upload session

Start a multipart upload session. Use this endpoint when you need to upload a file larger than 10 MB to a batch.

The multipart upload process consists of three steps:

  1. Create a multipart upload session (this endpoint)
  2. Upload file parts to the session
  3. Commit the session to finalize the upload
post/v2/batches/multipart-upload

Headers

Authorizationstring required

Bearer HTTP authentication.

IB-Contextstring

Typically your organization ID. See Authorization and context identification for details.

Request body

batch_idinteger required

The batch ID to upload the file to.

filenamestring required

A file name for the uploaded file on the AI Hub filesystem, including the file extension. Maximum of 255 characters.

file_sizeinteger required

The file size, in bytes. Can be an integer or a string.

Response

The multipart upload session was initiated.

session_idstring required

ID of the multipart upload session.

part_sizeinteger required

The number of bytes each part should be when uploading to the session. Each part should match the part_size, except for the final part, which can be smaller than the part_size.