Edit a library workflow
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.
POST
bearerheader
AuthorizationBearer <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.
Idempotency-Key?stringMakes 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._:-]+$Length
8 <= length <= 128application/json- body
input*confirmation?stringThe id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.
Done. A replay of the same key and input omits output.
application/json- response
status*unknownoutput?actionId*stringcurl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/workflows.update' \ -H 'Content-Type: application/json' \ -d '{ "input": { "workflowId": "string" }}'Example Response
{ "status": "done", "output": { "workflowId": "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"}