Skip to content
Gigmeister

Create song group

POST
/api/song-groups

Creates a new reusable song group.

Authorizations

Section titled “Authorizations ”

Request Body

Section titled “Request Body ”
object
name
required
string
>= 1 characters <= 200 characters
songIds
required
Array<string>

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Group created

object
ok
required
boolean
data
required
object
id
required

UUID identifier

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required
string
bandId
required

UUID identifier

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
songs
Array<object>
object
id
required

UUID identifier

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
title
required
string
artist
string
key

Musical key (e.g., Am, C, F#m)

string
tempo

BPM

integer
duration

Duration in seconds

integer
notes

Performance notes

string
timeSignature

Time signature (e.g., 4/4)

string
mediaUrl

Link to audio/video

string format: uri
tags
Array<string>
content

ChordPro formatted content (lyrics + chords)

string
leadVocal

Who sings lead

string
infoPa

Notes for sound engineer

string
twoColumnLayout
boolean
leadSheetUrl
string format: uri
updatedAt
string format: date-time
createdAt
string format: date-time
updatedAt
string format: date-time
createdAt
string format: date-time

401

Section titled “401 ”

Unauthorized

object
ok
required
boolean
error
required
string