Approve or deny an access request
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.
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.decideAccessRequest' \ -H 'Content-Type: application/json' \ -d '{ "input": { "shareId": "6a9e781b-5ee2-4314-8665-1c09eed0443a", "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6", "decision": "approve" }}'{ "status": "done", "output": { "shareId": "string", "requestId": "string", "status": "APPROVED" }, "actionId": "string"}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.
Duplicate a share list POST
Share the candidates of a Job's share list again as a new list, with the same visibility: by default named '<name> (copy)', with the same recipients (except revoked ones), note and expiry. Each recipient gets an email invitation. Pass the list's `version` from shares.get: a list changed since is refused.