Skip to Content
InvyteDocs
Jobs & workflows

Edit a workflow template

Rename or recategorise one of your organization's templates, or change its steps like workflows.update. Jobs already started from it keep their own steps.

POST
/operations/workflows.updateTemplate

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/workflows.updateTemplate' \  -H 'Content-Type: application/json' \  -d '{  "input": {    "templateId": "string"  }}'
Example Response
{  "status": "done",  "output": {    "templateId": "string",    "name": "string",    "steps": [      {        "id": "string",        "type": "string",        "kind": "string",        "title": "string",        "config": {          "property1": null,          "property2": null        },        "parentId": "string"      }    ],    "connections": [      {        "from": "string",        "to": "string",        "branch": "string"      }    ],    "ruleFields": [      {        "stepId": "string",        "field": "string",        "label": "string",        "type": "string",        "description": "string",        "numeric": {          "min": 0,          "max": 0,          "step": 0,          "displayScale": 0,          "unit": "percent"        },        "options": [          {            "value": "string",            "label": "string"          }        ]      }    ],    "addedStepIds": [      "string"    ],    "problems": [      {        "stepId": "string",        "message": "string"      }    ]  },  "actionId": "string"}

Remove a Job's assigned workflow POST

Take the assigned workflow off an unpublished Job. Its draft stays, to edit and assign again.

Edit a library workflow POST

Rename a library workflow or change its steps: add, remove, move or configure a step, or connect and disconnect steps. A Decision's rules read fields listed by workflows.decisionFields. A Job's workflow changes through workflows.saveJobDraft.