Set how an agent acts
Set how one of Invyte's working agents acts where their role reaches: per effect (write, outside, destructive) off, suggest (drafts only), ask (waits for a person's approval) or auto (commits and reports). The most specific place wins: Job, then Client, then organization. A mode never grants anything the role does not; destructive effects never go past ask. 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?replay?actionId*stringcurl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/access.setAgentModes' \ -H 'Content-Type: application/json' \ -d '{ "input": { "agt": "pipeline", "scope": "organization", "modes": {} }}'{ "status": "done", "output": { "assignmentId": "string", "agt": "pipeline", "modes": { "write": "off", "outside": "off", "destructive": "off" } }, "replay": { "assignmentId": "string" }, "actionId": "string"}Pause an agent or set its budget POST
Pause one of Invyte's working agents in the organization (it is refused everything at once and starts no work) or resume it, and set its monthly model budget in USD (null for Invyte's default). Admins only.
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.