List roles
List the organization's roles and what each grants. A role is held at the whole organization, a Client or one Job.
bearerAuthorizationBearer <API key or OAuth token>An organization API key (ink_live_…, ADR-0124), or the OAuth access token a person's AI client gets from the Recruiter MCP sign-in. Only the Authorization header is accepted.
Idempotency-Key?stringMakes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.
^[A-Za-z0-9._:-]+$8 <= length <= 128application/json- body
input*confirmation?stringThe id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.
Done. A replay of the same key and input omits output.
application/json- response
status*unknownoutput?actionId*stringcurl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/access.listRoles' \ -H 'Content-Type: application/json' \ -d '{ "input": {}}'{ "status": "done", "output": { "roles": [ { "id": "string", "name": "string", "description": "string", "isDefault": true, "capabilities": [ "job.create" ], "assignmentCount": 0 } ] }, "actionId": "string"}List who holds which role POST
List role assignments on a Job (anyone who sees it), or, for admins, on a Client, of one person, or across the organization. Anyone may list their own.
Restore a starting role POST
Put one of the four starting roles (Team Lead, Hiring Manager, Recruiter, Analyst) back to its default name, description and capabilities. It can take access away, so it waits for a go-ahead. Can be undone. Admins only.