Skip to content

Promote a Bench song into the running order

POST
/api/setlists/{id}/bench/{junctionId}/promote

Moves the song straight after afterJunctionId, taking that row’s set and medley setting; a missing or stale anchor lands it after the last song of the running order, before any closing notes. A row of a benched group promotes the whole group, adjacent, keeping its link and medley setting, and lands past the anchor’s own group rather than inside it. A song already promoted answers 200 with already: true.

id
required
string format: uuid
junctionId
required
string format: uuid
object
afterJunctionId
string format: uuid
nullable

Done

object
ok
required
boolean
data
nullable

Invalid input

object
ok
required
boolean
error
required
string
code
string

Unauthenticated

object
ok
required
boolean
error
required
string
code
string

Forbidden / no permission

object
ok
required
boolean
error
required
string
code
string

Setlist, song or entry not found

object
ok
required
boolean
error
required
string
code
string

Server error

object
ok
required
boolean
error
required
string
code
string