Record the response to an invitation

Stamps respondedAt and the response. An accepted invitation assigns the invited staff member to the gig role; a declined one clears the assignment if that person held it.

Path Parameters

id
Type: stringFormat: uuid
required

Gig role invitation id.

Body

required

application/json

response
Type: "accepted" or "declined" or "no_response"enum
required
notes
Type: string

Responses

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

post/gig-role-invitations/{id}/respond

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

Show Schema

{
  "data": {
    "invitation": {
      "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"
    },
    "gigRole": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "label": null,
      "roleId": null,
      "gigId": null,
      "staffMemberId": null,
      "gigProductId": null,
      "clientRequested": true,
      "training": true,
      "rateId": null,
      "latestInvitationId": null,
      "callTime": null,
      "callTimeLocation": null,
      "computedBaseAmount": null,
      "computedDayModifier": null,
      "computedAddonTotal": null,
      "computedTravelAmount": null,
      "computedTotalAmount": null,
      "createdTime": "2026-09-30T11:22:55.092Z",
      "lastEditedTime": "2026-09-30T11:22:55.092Z"
    }
  }
}

The outcome.