Skip to content

Bulk-import setlists

POST
/api/setlists/import

Creates setlists with positioned, section-marked songs. A live setlist with the same name and date is skipped, so a re-run of the same import is idempotent. Results align with the request order.

object
setlists
required
Array<object>
>= 1 items <= 200 items
object
name
required
string
>= 1 characters <= 200 characters
date
string
nullable /^\d{4}-\d{2}-\d{2}$/
songs
required
Array<object>
<= 500 items
object
songId
required
string format: uuid
sectionMarker
string
nullable <= 100 characters

Imported

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

Server error

object
ok
required
boolean
error
required
string
code
string