Skip to Content
InvyteDocs
Jobs & workflows

List Jobs

List the Jobs you can see, most recently updated first, with their status (draft, open, paused, closed or archived), Client and applicationCount (its applications at every stage, rejected and withdrawn included), a page at a time (`next`). Archived Jobs are included unless you filter by status; `status: archived` lists only them.

POST
/operations/jobs.list

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/jobs.list' \  -H 'Content-Type: application/json' \  -d '{  "input": {}}'
Example Response
{  "status": "done",  "output": {    "jobs": [      {        "id": "string",        "title": "string",        "department": "string",        "location": "string",        "status": "string",        "client": {          "id": "string",          "name": "string"        },        "applicationCount": 0,        "updatedAt": "2019-08-24T14:15:22Z",        "agentModes": {          "write": "string",          "outside": "string"        }      }    ],    "total": 0,    "next": "string"  },  "actionId": "string"}

View a Job POST

See one Job: its description, requirements, criteria and skills, company, salary band, AI Persona, Client and publication state, applicationCount (every stage), and, where you have access, its Sourcing setup, its workflow steps (each one a candidate can be placed at is marked) and how many candidates are in each Review Board column.

Publish a Job POST

Open a draft Job, or reopen a paused or closed one, on your public job board where anyone can apply; optionally list it on Google for Jobs. Opening a draft for the first time also starts its external sourcing when that is switched on: one paid partner search, checked against the daily sourcing budget like sourcing.start, and skipped (the Job still opens) when that budget is spent.