Update a gig song
Partial update: only the fields sent change.
Path Parameters
- Type: stringFormat: uuididrequired
Gig song id.
Body·
required
application/json
Any subset of writable fields. At least one is required. Unknown or read-only fields are rejected.
- Type: "couple" or "office" or nullenumadded
_by Who put it on the gig.
- Type: string | nullartist
- Type: string | nullFormat: uuidgig
_moment _id What the song is for, e.g. the first dance. References gig_moments.id.
- Type: string | nullFormat: uuidgig
_product _id The part of the gig this song belongs to. Removing the product from the gig removes its songs. References gig_products.id.
- Type: string | nullinternal
_notes Never shown to the couple.
- Type: "shortened" or "original" or nullenumlength
Shortened for the moment, or left at its original length.
- Type: string | nullFormat: urilink
The version meant, or a playlist.
- Type: string | nullenumlist
Which list the song is on for this gig.
valuesrequestset_listfavoriteplaylistdo_not_playnull - Type: string | nullnotes
- Type: number | nullorder
- Type: "live" or "recording" or nullenumperformance
Performed live by the band, or the recording played back.
- Type: string | nullsecond
_vocalist
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for patch/gig-songs/{id}
curl https://api.weddingoperatingsystems.com/api/v1/gig-songs/123e4567-e89b-12d3-a456-426614174000 \
--request PATCH \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"title": null,
"artist": null,
"link": null,
"gig_product_id": null,
"list": "request",
"song_id": null,
"gig_moment_id": null,
"performance": "live",
"length": "shortened",
"set": null,
"order": null,
"singer_id": null,
"second_vocalist": null,
"notes": null,
"internal_notes": null,
"added_by": "couple"
}'
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"title": null,
"artist": null,
"link": null,
"gig_product_id": null,
"list": "request",
"song_id": null,
"gig_moment_id": null,
"performance": "live",
"length": "shortened",
"set": null,
"order": null,
"singer_id": null,
"second_vocalist": null,
"notes": null,
"internal_notes": null,
"library_decision": "in_library",
"added_by": "couple",
"completed_at": null,
"set_aside_at": null,
"created_time": "2026-10-05T17:38:27.325Z",
"last_edited_time": "2026-10-05T17:38:27.325Z",
"stage": "needs_decision"
}
}