Invite a staff member to a gig role

Opens the next invitation round for this gig role: creates a gig_role_invitation with the next invitation_number, marks it invited now, and points the role’s latestInvitationId at it. Sending the message is up to the caller (or an automation).

Path Parameters

id
Type: stringFormat: uuid
required

Gig role id.

Body

required

application/json

staffMemberId
Type: stringFormat: uuid
required
notes
Type: string

Responses

application/json
application/json
application/json
application/json
application/json
application/json

post/gig-roles/{id}/invite

curl https://api.weddingoperatingsystems.com/api/v1/gig-roles/123e4567-e89b-12d3-a456-426614174000/invite \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "staffMemberId": "",
  "notes": ""
}'

Show Schema

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "gigRoleId": null,
    "staffMemberId": null,
    "invitationNumber": null,
    "invitedAt": null,
    "emailSentAt": null,
    "respondedAt": null,
    "response": null,
    "notes": null,
    "createdTime": "2026-09-30T11:22:55.092Z",
    "lastEditedTime": "2026-09-30T11:22:55.092Z"
  }
}

The outcome.