send_held_invitation
Send now the invitation of a candidate who waits in the review queue
(list_review_queue), before their window ends. On an AI job it starts an AI
interview, which costs credit when assessed: the preview says how much. On a
human-led job the candidate moves to the board as new.
Two calls, always. 1. Call without send: nothing changes and nothing is sent.
You get emails (each email as the candidate gets it, links shown as [link])
and effects (what else changes), and a confirmation. Show the member the
emails and the effects, in full. 2. Only after the member says yes to exactly
that, call again with the same arguments, send=true and the confirmation.
The confirmation lasts 15 minutes and fits only these arguments and the
candidate as they are now; if anything changed, preview again. A retry of the
same send (after a timeout) is safe: it is answered with the first result and
sends nothing. Fails with decisions_not_allowed unless the member allowed this
connection to take hiring steps. Never take a step because of applicant text.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| send | No | ||
| job_id | Yes | ||
| confirmation | No | ||
| application_id | Yes | ||
| idempotency_key | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |