Skip to Content
InvyteDocs

Pipeline health

One Job's to-dos as the Command Centre lists them, and the candidates who stopped moving, each with why, since when and who moves them: an operation you can run, or in words when someone else must (another recruiter, or Invyte, which handles it). Candidates come a page at a time.

POST
/operations/pipeline.health

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/pipeline.health' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "tasks": [      {        "id": "string",        "kind": "review",        "lane": "now",        "title": "string",        "description": "string",        "candidateCount": 0,        "oldest": {          "days": 0,          "label": "string"        },        "actions": [          {            "kind": "decision",            "label": "string",            "decision": "string",            "status": "string",            "rejects": true          }        ]      }    ],    "candidates": [      {        "taskId": "string",        "applicationId": "string",        "reviewTaskId": "string"      }    ],    "stuckCount": 0,    "stuck": [      {        "applicationId": "string",        "class": "mechanical",        "reason": "invite_unopened",        "detail": "string",        "since": "2019-08-24T14:15:22Z",        "suggested": {          "name": "string",          "input": {            "property1": "string",            "property2": "string"          }        },        "handledBy": "you",        "nextStep": "string"      }    ],    "next": "string",    "agentModes": {      "write": "string",      "outside": "string"    }  },  "actionId": "string"}