Role change history
The organization's role changes, newest first: who changed which role, what it added or removed, and whether it can still be undone. Admins only.
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.roleHistory' \ -H 'Content-Type: application/json' \ -d '{ "input": {}}'{ "status": "done", "output": { "changes": [ { "changeId": "string", "roleId": "string", "roleName": "string", "action": "created", "actorUserId": "string", "at": "2019-08-24T14:15:22Z", "added": [ "job.create" ], "removed": [ "job.create" ], "renamedFrom": "string", "undoable": true, "undone": true } ], "nextCursor": "string" }, "actionId": "string"}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.
Preview a role change POST
See what editing a role, or deleting it, would change: the capabilities added and lost, how many people hold it and how many invitations not accepted yet hold it, the Jobs it reaches, and the Human Review steps that name it when it would no longer decide. Admins only.