Share a Talent Hub shortlist
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.
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.createFromTalentHub' \ -H 'Content-Type: application/json' \ -d '{ "input": { "name": "string", "people": [ { "personKey": "string" } ], "recipients": [ "user@example.com" ] }}'{ "status": "done", "output": { "sharePublicId": "string", "recipients": [ { "email": "string", "delivery": "sending" } ] }, "replay": { "sharePublicId": "string" }, "actionId": "string"}Close a share POST
Close a Candidate Share for good: nobody can open it again and pending access requests can no longer be approved.
Share candidates POST
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.