Skip to content

Link a live take to a setlist and/or event, or clear a link

PATCH
/api/song-audio/{id}/links

A live take belongs to the band; setlist and event are optional links. Omit a key to keep it, pass null to clear it. The file and song markers never move.

id
required
string format: uuid
object
setlistId
string format: uuid
nullable
eventId
string format: uuid
nullable

Success

object
ok
required
boolean
data
nullable

Bad request / invalid input

object
ok
required
boolean
error
required
string
code
string

Unauthenticated

object
ok
required
boolean
error
required
string
code
string

Forbidden / not in band

object
ok
required
boolean
error
required
string
code
string

Not found

object
ok
required
boolean
error
required
string
code
string

Server error

object
ok
required
boolean
error
required
string
code
string