View a role
See what one role grants and how many assignments hold it.
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.getRole' \ -H 'Content-Type: application/json' \ -d '{ "input": { "roleId": "string" }}'{ "status": "done", "output": { "role": { "id": "string", "name": "string", "description": "string", "isDefault": true, "capabilities": [ "job.create" ], "assignmentCount": 0 } }, "actionId": "string"}Delete a role POST
Delete a role: everyone holding it loses it, everywhere. Undoing it later brings back only assignments whose person, Job or Client still exists. Admins only. Shows who loses what before it is done.
Invite someone with a role POST
Give a role to someone by email. A member gets it at once; anyone else is emailed an invitation to join the organization and gets the role when they accept.