Remove a role
Take a role away from someone where they hold it. They lose what it grants there unless another role gives it. Shows what they lose before it is done.
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.unassign' \ -H 'Content-Type: application/json' \ -d '{ "input": { "assignmentId": "string" }}'{ "status": "done", "output": { "assignmentId": "string" }, "actionId": "string"}Give Invyte's agents a role POST
Give Invyte's agents a role organization-wide, on every Job of a Client, or on one Job, replacing the role they hold there; or take their role there away (roleId null). roleId `admin`, organization-wide only, gives them an admin's reach except organization settings (profile, members, roles, their own access, approvals, integrations). Every working agent shares it and still calls only its own work (Intake drafts and publishes Jobs, Sourcing finds people, and so on); with no role anywhere they can do nothing in the organization. Modes set at that place stay. Admins only.
Undo a role change POST
Undo a role's latest change: an edit or restore puts the role back as it was, a delete brings the role back with the assignments that still apply, and a create deletes a role nobody holds yet. An undo can't itself be undone, and it can take access away, so it waits for a go-ahead. Admins only.