Skip to Content
InvyteDocs
Clients & delivery

Accept a request

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.

POST
/operations/requests.accept

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?
replay?
actionId*string
Example Request
curl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/requests.accept' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "requestId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "id": "string",    "kind": "new_role",    "status": "new",    "trust": "unknown",    "channel": "email",    "threadId": "string",    "from": "string",    "text": "string",    "facts": {      "title": "string",      "location": "string",      "workplace": "onsite",      "compensation": "string",      "headcount": 1,      "startBy": "string",      "mustHaves": [        "string"      ],      "niceToHaves": [        "string"      ],      "company": "string",      "notes": "string"    },    "missing": [      "title"    ],    "client": {      "id": "string",      "name": "string"    },    "job": {      "id": "string",      "title": "string"    },    "assignee": {      "kind": "autopilot"    },    "outcome": "string",    "shortlist": {      "target": 1,      "needsJob": true,      "people": [        {          "key": "string",          "label": "string",          "fitNote": "string"        }      ],      "share": {        "shareId": "string",        "people": 0,        "sharedAt": "2019-08-24T14:15:22Z"      },      "told": true,      "picks": [        {          "key": "string",          "added": true        }      ]    },    "declinedReason": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "replay": {    "requestId": "string",    "status": "string"  },  "actionId": "string"}

Delivery status for a Job POST

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.

Your requests address POST

The organization's open address: anyone may email a hiring need there (an agency can forward its own jobs@ address to it), and it becomes a request waiting to be accepted. Null while inbound email isn't set up.