Initiate chunked upload

Initiates a chunked upload session for large files. Returns a unique upload UUID and chunk configuration to use for subsequent chunk uploads.

Method: POST

URL: https://example.com/<MIXPOST_CORE_PATH>/api/<workspaceUuid>/media/chunked/initiate

Authorization: Bearer <token>

Body:

{
  "filename": "video.mp4",
  "mime_type": "video/mp4",
  "total_size": 52428800
}

Key	Format	Required	Description
filename	string	required	The name of the file being uploaded. Max 255 characters.
mime_type	string	required	The MIME type of the file. Must be one of the configured allowed types (e.g. image/jpeg, video/mp4).
total_size	integer	required	Total file size in bytes. Must not exceed the maximum allowed file size for the given MIME type.

Response:

200

{
  "upload_uuid": "a3f1b2c4-d5e6-7890-abcd-ef1234567890",
  "chunk_size": 10485760,
  "total_chunks": 5
}

401

{
  "message": "Unauthenticated."
}

403

{
  "message": "Access forbidden."
}

404

{
  "message": "Workspace not found."
}

422

{
  "message": "Validation errors",
  "errors": {}
}