Revoke someone's access to a share
Take one recipient's access to a Candidate Share away now (the recipient ids are in shares.get).
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/shares.revokeRecipient' \ -H 'Content-Type: application/json' \ -d '{ "input": { "shareId": "6a9e781b-5ee2-4314-8665-1c09eed0443a", "recipientId": "afdd332c-8290-47b9-aca2-368bf5f25a9d" }}'{ "status": "done", "output": { "shareId": "string", "recipientId": "string", "revokedAt": "2019-08-24T14:15:22Z" }, "actionId": "string"}Reshare a fixed share POST
Share a fixed (older, non-list) Candidate Share's candidates with new people: a new share showing what the original still can. Each recipient gets an email invitation. Share lists are duplicated instead.
Undo an access request decision POST
Undo the decision on an access request: an approval takes the access it gave away again; a denial puts the request back to pending.