Follow-ups due with Clients
The follow-ups due now on candidates waiting on Clients, one per Job and kind, in order. Computed from when each candidate was sent, so a missed check loses nothing.
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/delivery.dueFollowUps' \ -H 'Content-Type: application/json' \ -d '{ "input": {}}'{ "status": "done", "output": { "due": [ { "jobId": "string", "clientId": "string", "deliveryId": "string", "kind": "reminder_24h", "dueAt": "2019-08-24T14:15:22Z", "applicationIds": [ "string" ] } ] }, "actionId": "string"}Send candidates to a Client POST
Send a Job's candidates to its Client: one email from your agent to the Client's contacts, copying your team on the Job, and a Slack card when the Client's channel is connected. On a Job with no Client, its hiring team (everyone assigned to the Job, or the admins when nobody is) gets the same shortlist and email. Each candidate hears their profile was shared. If the hiring side already heard about this Job in the last day, the candidates go with the next follow-up as "N more added".
Send a follow-up to a Client POST
Send one due follow-up for a Job (from `delivery.dueFollowUps`): a reminder, digest, 72h notice or courtesy-day note to the Client, or the escalation to the Client's account owner (also due at once when every channel refused a delivery). Refused when it is not due.