PUT /tracks/{track}/files/{fileType}

Upload new file

Upload a new file for a track. If a file of the same asset type already exists, it will be replaced. Files are processed asynchronously and made available for distribution upon successful processing.

For stereo/dolby (choose one):

1. S3 upload: { "s3_key": "uuid/song.wav" } - File is queued for async processing (202 Accepted)
2. Remote URL: { "source_url": "https://...", "checksum": "sha256" } - File is downloaded, then queued for transcoding (201 Created)

Supported audio formats: WAV (16-, 24-, or 32-bit) or FLAC (16-bit only). Hi-res FLAC sources (>16-bit) are rejected with 422 — upload WAV for hi-res delivery.

For lyrics (LRC only):

• S3 upload: { "s3_key": "uuid/lyrics.lrc" } - LRC file is queued for processing (202 Accepted). Only .lrc format via s3_key is supported.

Note: File is queued for processing. Check status via GET endpoint.

Parameters

• track (path)
• fileType (path)

Responses

• 201 — `FileData`
• 202
• 422
• 404
• 401