Create a role
Body·
required
application/json
Fields accepted when creating a role. Unknown or read-only fields are rejected.
- Type: string | nulllabelrequired
- Type: string | nullcategory
- Type: booleandefault
_on _gig Every new gig starts with an open slot for this role (e.g. Band Leader, Coordinator).
- Type: number | nullorder
- Type: "inactive" or "active" or nullenumstatus
Active roles are assignable; inactive are retired.
- Type: string | nullFormat: uuidteam
_id The role grouping used for ordering and display (replaces the legacy Section). References teams.id.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for post/roles
curl https://api.hireorpheus.com/api/v1/roles \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"label": null,
"status": "inactive",
"team_id": null,
"order": null,
"category": null,
"default_on_gig": true
}'
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"label": null,
"status": "inactive",
"team_id": null,
"order": null,
"category": null,
"default_on_gig": true,
"created_time": "2026-10-14T08:02:53.591Z",
"last_edited_time": "2026-10-14T08:02:53.591Z"
}
}