Share candidates
Share up to 25 of a Job's candidates with people outside your organization as a named share list, as the share composer does. Each recipient gets an email invitation and signs in with a code; they see only the chosen sections (by default everything but contact details, with full interviews and assessment overviews), including newer results as they come, until the list is closed or its access ends.
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.create' \ -H 'Content-Type: application/json' \ -d '{ "input": { "jobId": "string", "applicationIds": [ "string" ], "name": "string", "recipients": [ "user@example.com" ] }}'{ "status": "done", "output": { "sharePublicId": "string", "recipients": [ { "email": "string", "delivery": "sending" } ] }, "replay": { "sharePublicId": "string" }, "actionId": "string"}Share a Talent Hub shortlist POST
Share up to 25 people from your Talent Hub, without a Job, as a live list. Each recipient gets an email invitation and signs in with a code. Contact details are never shared; each person may carry a 'why they match' line. People who haven't agreed to be shared or aren't verified are flagged in the review. Name the request it answers (`requestId`) to send a request's Talent Hub shortlist.
Approve or deny an access request POST
Decide a pending request for access to a share list. Approving emails them an invitation to the list; denying tells them on the request page that it was declined.