Skip to Content
InvyteDocs
Jobs & workflows

Edit a published Job

Change a published Job's details or its Sourcing setup. The Job must stay complete; its workflow and candidates are unchanged.

POST
/operations/jobs.update

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.update' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "jobId": "string",    "updatedAt": "2019-08-24T14:15:22Z"  },  "actionId": "string"}

Pause or close a Job POST

Pause a published Job (it stops taking applications and leaves your job board until reopened with jobs.publish), or close it (the same, and candidates' scheduled reminder emails are cancelled). Pausing needs Publish Jobs; closing needs Archive Jobs.

List locations POST

Where the open Jobs you can see are, and where the applicants of Jobs whose pipeline you see are, grouped by country, then state, then city.