Create Multipart Upload

POST/v1/files/uploads

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Request Body

filenamestringrequired

Name of the file including extension

Constraints

•Minimum length: 1

file_sizeintegerrequired

Total size of the file in bytes

Constraints

•Exclusive minimum: 0

mime_typestringrequired

MIME type of the file

part_countinteger

Number of parts to split the upload into. Defaults to `1`.

Constraints

•Minimum: 1•Maximum: 10000

Response Body

idstringrequired

The multipart upload ID (use this to complete or abort)

Request

POST/v1/files/uploads

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

res = mxbai.files.uploads.create(
    filename="large-document.pdf",
    file_size=104857600,
    mime_type="application/pdf",
    part_count=10,
)

print(res)

Response

JSON

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "part_urls": [
    {
      "part_number": 1,
      "url": "https://storage.example.com/upload?partNumber=1&uploadId=..."
    },
    {
      "part_number": 2,
      "url": "https://storage.example.com/upload?partNumber=2&uploadId=..."
    }
  ]
}