musiccompanion. assets

Uploaded audio files. An asset can be attached to an entity, or uploaded with "retention": "standalone" to exist only for analysis. GET /api/v1/musiccompanion/assets/{id}/download signs a short-lived read URL for the same file the product UI plays or displays.

📄️Upload an audio file (returns a signed upload URL)

Creates an UPLOADING asset and a signed upload target. PUT the raw file bytes, not multipart form data, to upload.url with every returned upload.headers entry before upload.expiresOn. After the PUT succeeds, call POST /api/v1/musiccompanion/assets/{id}/confirm with the returned assetId to move the asset to ONLINE.

📄️Confirm an uploaded asset

Verify that the file reached the signed upload target and change the asset from UPLOADING to ONLINE. Call this only after the raw-file PUT succeeds.

📄️Retrieve asset metadata and status

Retrieve asset metadata and status

📄️Get a short-lived signed URL for the file

Signs a read URL for the asset, the same way the product UI streams audio and displays artwork. The URL expires; request a fresh one per use rather than storing it.