Update a song

PATCH

/api/songs/{id}

• Production
• Local Development

Optimistic locking via baselineUpdatedAt. Returns 409 with serverVersion if the row has changed.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body

object

id

string format: uuid

title

string

>= 1 characters <= 500 characters

artist

string

<= 500 characters

key

string

<= 20 characters /^[A-G][b#]?(m|min|maj|dim|aug|sus[24]?|add\d+|\/[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

midiClipLoopCount

integer

nullable

twoColumnLayout

boolean

leadSheetUrl

Any of:

string

string format: uri

<= 500 characters

string

string

Allowed values: ""

leadSheetPath

string

<= 500 characters

leadSheetType

string

Allowed values: pdf png jpg

leadSheetUploadedAt

string format: date-time

stepsEnabled

boolean

clickTrackEnabled

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

preferredRecordingId

string format: uuid

nullable

key

additional properties

nullable

Responses

200

Updated

object

ok

required

boolean

data

nullable

400

Invalid input

object

ok

required

boolean

error

required

string

code

string

404

Not found

object

ok

required

boolean

error

required

string

code

string

409

Conflict

object

ok

required

boolean

error

required

string

Allowed values: conflict

code

required

string

serverVersion

nullable

500

Server error

object

ok

required

boolean

error

required

string

code

string