v68

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-07344691.3 MB
Workflows

Patch a workflow definition (create/update/delete nodes)

patch/api/workflows/{id}

Path parameters

idstring required

Request body

deletestring[]

Node IDs to delete

onNodeFailure'fail' | 'continue'

Update the definition-level onNodeFailure behavior

triggerSchemaobject nullable

Optional JSON-Schema describing the expected trigger payload shape. Pass an object to set/replace; pass null to clear; omit to leave unchanged. Validator subset: type, required, properties, enum, const, items. Other JSON-Schema keywords are silently ignored.

keystring

Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

Response

Workflow patched (version snapshot created)

idstring uuid required
keystring required

Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

namestring required
descriptionstring
enabledboolean required
inputobject
triggerSchemaobject
dirstring
vcsRepostring
createdByAgentIdstring
createdAtstring required
lastUpdatedAtstring required
createdBystring
updatedBystring
favoriteboolean