Create a song

POST

/api/songs

Production

Authorizations

bearerAuth

Request Body

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

string format: uri

<= 500 characters

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

string format: uri

<= 500 characters

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

Responses

201

Created

object

ok

required

boolean

data

nullable

400

Invalid input or no band

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