Mark a song-scoped asset as the song’s preferred take

POST

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

• Production
• Local Development

Sets songs.preferred_song_audio_id. Covers reference takes the legacy preferred_recording_id cannot point at; for mirrored stems assets the pointer-sync trigger keeps both generations aligned.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body

object

preferred

boolean

default: true

Responses

200

Success

object

ok

required

boolean

data

nullable

400

Bad request / invalid input

object

ok

required

boolean

error

required

string

code

string

401

Unauthenticated

object

ok

required

boolean

error

required

string

code

string

403

Forbidden / not in band

object

ok

required

boolean

error

required

string

code

string

404

Not found

object

ok

required

boolean

error

required

string

code

string

409

Preferred take was changed by another member

object

ok

required

boolean

error

required

string

code

string

500

Server error

object

ok

required

boolean

error

required

string

code

string