Invite someone to a share
Give one more person access to an open Candidate Share of a Job: they get an email invitation and see what the share shows.
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/shares.inviteRecipient' \ -H 'Content-Type: application/json' \ -d '{ "input": { "jobId": "string", "sharePublicId": "4978d091-2838-4f73-ac20-12773035f1c9", "email": "user@example.com" }}'{ "status": "done", "output": { "sharePublicId": "string", "grantPublicId": "string", "expiresAt": "2019-08-24T14:15:22Z", "delivery": "sending" }, "replay": { "sharePublicId": "string", "grantPublicId": "string" }, "actionId": "string"}View a Candidate Share POST
One Candidate Share: the candidates on it and what is shared about them, each recipient's access and invitation, when they opened it, and their fit marks and introduction requests.
List Candidate Shares POST
The Candidate Shares you manage, newest first, or one Job's: who they went to, how many candidates, and when recipients last opened them.