Edit a share list
Change an open share list of a Job: its name, recipients (new addresses get an email invitation, removed ones lose access), when access ends, the note, whether viewers may add viewers, its candidates, and what each candidate shows. The link stays the same. Pass the list's `version` from shares.get: if anyone changed the list since, nothing changes and the call is refused. Only share lists can be edited; a fixed share can be reshared instead.
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.update' \ -H 'Content-Type: application/json' \ -d '{ "input": { "shareId": "6a9e781b-5ee2-4314-8665-1c09eed0443a", "version": "string" }}'{ "status": "done", "output": { "shareId": "string", "revision": 0, "invited": [ "string" ] }, "actionId": "string"}