Bulk-import songs (1–100)

POST

/api/songs/import

• Production

Authorizations

• bearerAuth

Request Body

object

songs

required

Array<object>

>= 1 items <= 100 items

object

id

string format: uuid

title

required

string

>= 1 characters <= 500 characters

artist

string

<= 500 characters

key

string

<= 20 characters /^[A-G][b#]?(?:(?:maj|min|m|M|dim|aug|sus|add|°|Δ|\+)|[0-9]+|[b#][0-9]+)*(?:\/[A-G][b#]?)?$/i/

tempo

integer

>= 20 <= 400

duration

integer

<= 3600

content

string

<= 100000 characters

notes

string

<= 10000 characters

timeSignature

string

<= 20 characters

leadVocal

string

<= 200 characters

infoPa

string

<= 5000 characters

mediaUrl

string

<= 500 characters

tags

Array<string>

<= 20 items

midiClipUrl

Any of:

string

string format: uri

<= 500 characters

string

string

Allowed values: ""

midiClipPath

string

<= 500 characters

midiClipName

string

<= 200 characters

midiClipDeviceId

string format: uuid

nullable

midiClipLoopCount

integer

nullable <= 64

stepsEnabled

boolean

clickTrackEnabled

boolean

needsRehearsal

boolean

backingTrackUrl

Any of:

string

string format: uri

<= 500 characters

string

string

Allowed values: ""

backingTrackPath

string

<= 500 characters

backingTrackName

string

<= 200 characters

backingTrackUploadedAt

string format: date-time

backingTrackLoopCount

integer

nullable <= 64

backingTrackStartTime

number

nullable

backingTrackEndTime

number

nullable

backingTrackAutoTrigger

boolean

backingTrackPlaybackRate

number

nullable >= 0.5 <= 2

backingTrackPitchSemitones

integer

nullable >= -12 <= 12

preferredRecordingId

string format: uuid

nullable

leadSheetUrl

Any of:

string

string format: uri

<= 500 characters

string

string

Allowed values: ""

chartVersions

Array<object>

<= 5 items

object

name

required

string

>= 1 characters <= 100 characters

content

required

string

>= 1 characters <= 100000 characters

source

string

Allowed values: bandhelper chordpro csv paste pdf assistant other

Responses

200

Imported

object

ok

required

boolean

data

nullable

400

Invalid input

object

ok

required

boolean

error

required

string

code

string

401

Unauthenticated

object

ok

required

boolean

error

required

string

code

string

403

Forbidden / no permission

object

ok

required

boolean

error

required

string

code

string

500

Server error

object

ok

required

boolean

error

required

string

code

string