Upload Track Audio Chunk

Upload one chunk of a larger audio file using a stable upload_session_id, chunk_index, and total_chunks. After all chunks are accepted, use the returned audio_file_id in track metadata calls.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Header Parameters

X-User-Id*string

Public user_id in the API client organization. Requires users:act-as and supplies catalog ownership and quota context.

Formatuuid

Request Body

multipart/form-data

Multipart request payload.

TypeScript Definitions

Use the request body type in TypeScript.

upload_session_id?string

Stable client-generated upload session reference. Reuse it for every chunk and status check.

Match^[A-Za-z0-9_-]{1,80}$

chunk_index*integer

Zero-based sequence number for this uploaded chunk within the upload session. The first chunk is 0.

total_chunks*integer

Total number of chunks expected for the upload session.

Range1 <= value <= 64

file_name*string

Original audio file name, including a supported extension.

Lengthlength <= 255

file_size*integer

Total size of the complete audio file in bytes.

Range1 <= value <= 524288000

chunk*file

Binary chunk for a multipart audio upload session.

Formatbinary

[key: string]?any

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/tracks/upload/chunk" \  -H "X-User-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -F upload_session_id="upload_midnight_atlas_20260704" \  -F chunk_index="3" \  -F total_chunks="8" \  -F file_name="midnight-atlas-master.wav" \  -F file_size="83886080" \  -F chunk="midnight-atlas-master.part001"

{  "success": true,  "upload_session_id": "upload_midnight_atlas_20260704",  "received_chunks": [    0,    1,    2,    3  ],  "total_chunks": 8,  "complete": false,  "state": "receiving",  "expires_at": "2026-07-04T10:15:00+00:00",  "message": "Chunk uploaded successfully"}

Authorization

Header Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`