Skip to Content
InvyteDocs
Pipeline

Pipeline situations

Each undecided candidate on a Job with the facts that decide whether to act: UMatch fit against the Job's floor, how they engaged, their Decision path and its track, momentum against the Job, whether the Job still needs people, and nudges sent. `allowed` is what an agent may do for them now, already filtered by the nudge limits; fast-track candidates come first. Without `jobId`, every open Job you can see, one Job a page.

POST
/operations/pipeline.situations

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.situations' \  -H 'Content-Type: application/json' \  -d '{  "input": {}}'
Example Response
{  "status": "done",  "output": {    "job": {      "id": "string",      "status": "string",      "nudgesToday": 0,      "nudgesLeftToday": 0,      "agentModes": {        "write": "string",        "outside": "string"      }    },    "limits": {      "perApplication": 0,      "standardGapDays": 0,      "fastIdleDays": 0,      "quietAfterEmailDays": 0,      "recruiterAfterDays": 0,      "perJobPerDay": 0    },    "situations": [      {        "applicationId": "string",        "jobId": "string",        "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"        },        "idle": {          "since": "2019-08-24T14:15:22Z",          "days": 0        },        "fit": {          "score": 0,          "tier": "string",          "floor": 0,          "standing": "above"        },        "engagement": "replied",        "path": {          "name": "string",          "track": "fast",          "stepsLeft": 0        },        "momentum": {          "daysPerStep": 0,          "jobMedian": 0,          "faster": true        },        "need": {          "needed": true,          "shortlisted": 0,          "target": 0,          "source": "target"        },        "history": {          "nudges": 0,          "lastNudgeAt": "2019-08-24T14:15:22Z",          "lastEmailAt": "2019-08-24T14:15:22Z"        },        "priority": "fast",        "heldByPerson": true,        "allowed": [          "nudge"        ],        "nudgeBlocked": "job_not_open"      }    ],    "next": "string"  },  "actionId": "string"}

Turn reminder emails on or off POST

Schedule reminder emails asking a candidate to finish their steps (gentle, standard or finish today), or stop them.

Undo a Nudge POST

Call back a Nudge before it goes, by the notificationId pipeline.nudge or outreach.send returned, until its undoUntil. After that it has been sent and can't be undone.