List Candidate Shares
The Candidate Shares you manage, newest first, or one Job's: who they went to, how many candidates, and when recipients last opened them.
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.list' \ -H 'Content-Type: application/json' \ -d '{ "input": {}}'{ "status": "done", "output": { "shares": [ { "shareId": "string", "label": "string", "jobTitle": "string", "createdBy": "string", "createdAt": "2019-08-24T14:15:22Z", "candidateCount": 0, "activeRecipientCount": 0, "live": true, "pendingAccessRequests": 0, "expiresAt": "2019-08-24T14:15:22Z", "lastOpenedAt": "2019-08-24T14:15:22Z", "status": "OPEN" } ] }, "actionId": "string"}Invite someone to a share POST
Give one more person access to an open Candidate Share of a Job: they get an email invitation and see what the share shows.
Preview a share as its recipients see it POST
What recipients of a Candidate Share see right now, per candidate: the name (unless hidden), the sections they see masked, the evaluation, each interview and assessment round at its level, and whether the resume file and hiring team notes are shared. Recordings and files open only in the app.