Promote a segment of a single-file recording to a song reference

POST

/api/song-audio/{id}/promote

• Production
• Local Development

Creates a role=reference asset scoped to the song, sharing the source file with the trim window in its playback config. The source must carry exactly one file-backed track (a board mix, not a multi-stem set).

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body

object

songId

required

string format: uuid

startMs

required

integer

endMs

required

integer

name

string

>= 1 characters <= 200 characters

Responses

201

Created

object

ok

required

boolean

data

nullable

400

Bad request / source asset has no file track

object

ok

required

boolean

error

required

string

code

string

401

Unauthenticated

object

ok

required

boolean

error

required

string

code

string

403

Forbidden

object

ok

required

boolean

error

required

string

code

string

404

Asset or song not found

object

ok

required

boolean

error

required

string

code

string

500

Server error

object

ok

required

boolean

error

required

string

code

string