Record the response to an invitation

Stamps responded_at 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.hireorpheus.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",
      "gig_role_id": null,
      "staff_member_id": null,
      "invitation_number": null,
      "invited_at": null,
      "email_sent_at": null,
      "responded_at": null,
      "response": null,
      "notes": null,
      "created_time": "2026-10-14T08:02:53.594Z",
      "last_edited_time": "2026-10-14T08:02:53.594Z"
    },
    "gig_role": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "label": null,
      "role_id": null,
      "gig_id": null,
      "staff_member_id": null,
      "gig_product_id": null,
      "training": true,
      "rate_id": null,
      "latest_invitation_id": null,
      "call_time": null,
      "call_time_location": null,
      "computed_base_amount": null,
      "computed_day_modifier": null,
      "computed_addon_total": null,
      "computed_travel_amount": null,
      "computed_total_amount": null,
      "created_time": "2026-10-14T08:02:53.594Z",
      "last_edited_time": "2026-10-14T08:02:53.594Z"
    }
  }
}

The outcome.

Delete a gig role invitation

List staff member roles