Skip to Content
InvyteDocs
Jobs & workflows

Publish a live Job's workflow draft

Make a live Job's workflow draft the workflow its candidates follow: new applicants from now on, and the current candidates you choose (they may be emailed that new steps were added). Send the draft revision you previewed; a draft that changed since is refused.

POST
/operations/workflows.publishToJob

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/workflows.publishToJob' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "jobId": "string",    "reason": "string",    "expectedRevision": 0  }}'
Example Response
{  "status": "done",  "output": {    "jobId": "string",    "publicationId": "string",    "workflow": {      "id": "string",      "name": "string"    },    "movingCount": 0  },  "replay": {    "jobId": "string",    "publicationId": "string",    "workflowId": "string"  },  "actionId": "string"}

Preview publishing a Job's workflow draft POST

Before publishing a live Job's workflow draft: each step change against the current workflow and against each older version candidates are still on, and which current candidates could move onto it and why the others can't.

Edit a Job's workflow draft POST

Change the steps of a Job's workflow draft: add, remove, move or configure a step, or connect and disconnect steps; rename it. A Decision's rules read fields listed by workflows.decisionFields. Candidates are unaffected until it is assigned (workflows.assign) or, on a live Job, published (workflows.publishToJob).