Skip to Content
InvyteDocs
Clients & delivery

Delivery status for a Job

What was sent to the Job's Client and when, each candidate's current decision with the Client's reason, their response clock, and the next follow-up due on them.

POST
/operations/delivery.status

Authorization

bearer
headerAuthorizationBearer <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.

Header Parameters

Idempotency-Key?string

Makes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.

Match^[A-Za-z0-9._:-]+$
Length8 <= length <= 128

Request Body

application/json
  1. body
input*
confirmation?string

The id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.

Response Body

Done. A replay of the same key and input omits output.

application/json
  1. response
status*unknown
output?
actionId*string
Example Request
curl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/delivery.status' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "jobId": "string",    "clientId": "string",    "hiringSide": {      "kind": "client",      "memberUserIds": [        "string"      ]    },    "deliveries": [      {        "deliveryId": "string",        "status": "queued",        "createdAt": "2019-08-24T14:15:22Z",        "sentAt": "2019-08-24T14:15:22Z",        "candidateCount": -9007199254740991,        "agreementVersion": -9007199254740991      }    ],    "candidates": [      {        "applicationId": "string",        "deliveryId": "string",        "sentAt": "2019-08-24T14:15:22Z",        "unreached": true,        "decision": {          "decisionId": "string",          "decision": "approve",          "reason": "string",          "source": "client",          "memberUserId": "string",          "at": "2019-08-24T14:15:22Z"        },        "waitingHours": 0,        "lastFollowUp": "reminder_24h",        "escalated": true,        "candidateTold": true,        "next": {          "kind": "reminder_24h",          "dueAt": "2019-08-24T14:15:22Z"        }      }    ],    "waiting": {      "count": -9007199254740991,      "oldestSentAt": "2019-08-24T14:15:22Z"    }  },  "actionId": "string"}

Client response times POST

Per Client: candidates waiting and the oldest, how many were decided, median and average hours to a decision, and escalations. Over the Jobs you can see.

Accept a request POST

Take on a request from someone who isn't a Client yet: into one of your Clients, or a new Client named here (its first hiring manager is the sender). Autopilot's Intake works it, or you do (`assignTo: me`). Any member may accept.