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 latest_invitation_id at it. Sending the message is up to the caller (or an automation).
Path Parameters
- Type: stringFormat: uuididrequired
Gig role id.
Body
required
application/json
- Type: stringFormat: uuidstaff
_member _id required - Type: stringnotes
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for post/gig-roles/{id}/invite
curl https://api.hireorpheus.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 '{
"staff_member_id": "",
"notes": ""
}'
{
"data": {
"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.607Z",
"last_edited_time": "2026-10-14T08:02:53.607Z"
}
}