Skip to Content
InvyteDocs
Autopilot & approvals

Read an approval request

Read one request an agent is waiting on you to approve, as it stands now: what it shows, the whole input approving runs, whether it can be changed, and the changes people made to it. Any revision's id answers with the current one.

POST
/operations/approvals.get

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/approvals.get' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "approvalId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "id": "string",    "reviewDigest": "string",    "operation": "string",    "agentId": "string",    "jobId": "string",    "job": {      "title": "string",      "clientId": "string",      "clientName": "string"    },    "review": {      "summary": "string",      "details": {        "property1": null,        "property2": null      }    },    "rationale": "string",    "alwaysAllow": [      {        "scope": "job",        "consequence": "string"      }    ],    "requestedAt": "2019-08-24T14:15:22Z",    "expiresAt": "2019-08-24T14:15:22Z",    "input": {      "property1": null,      "property2": null    },    "revisable": true,    "edits": [      {        "by": "string",        "via": "lisa",        "fields": [          "string"        ],        "at": "2019-08-24T14:15:22Z"      }    ]  },  "actionId": "string"}

Approve or reject POST

Approve or reject an action an agent is waiting on, or approve it with your own edits. The agent goes ahead only after an approval, with exactly what was approved. An organization admin may also approve and always allow (alwaysAllow: job or client): the agent then takes that kind of action on that Job, or on the Client's Jobs, without asking.

List approvals POST

List actions an agent is waiting for you to approve: those you could take yourself.