Hand a candidate to another agent
Make one working agent own a person on a Job, whatever their stage says, until they close; agentId null hands them back to the default. The reason is kept with the override.
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/owners.override' \ -H 'Content-Type: application/json' \ -d '{ "input": { "jobId": "string", "subject": "string", "agentId": "sourcing", "reason": "string" }}'{ "status": "done", "output": { "subject": "string", "owner": "sourcing", "derived": "sourcing", "state": { "kind": "application", "status": "SUBMITTED" }, "override": { "agentId": "sourcing", "reason": "string", "setAt": "2019-08-24T14:15:22Z", "setBy": "string" }, "ownedBy": { "kind": "agent", "agent": "string" } }, "actionId": "string"}Who owns these candidates POST
Which working agent owns each person on a Job now (sourcing, communication, pipeline or delivery), worked out from where they stand, with any override a person or the orchestrator set, and whether a person holds them (ownedBy kind person: leave them alone). Ids and states only.
Approve a playbook POST
Make a proposed (or retired: a rollback) playbook the agent's current one, retiring the version it replaces, or decline a proposal. Refused while its labelled-set evaluation is missing or regressed.