Restore Workflow Version

Copy a saved version into the draft, replacing it. The current draft is kept as a safety copy, as the editor keeps it. Publish afterwards to make it run. Send the revision you last read in If-Match; the response's meta.revision is the new one.

POST

Path

Path parameters

stringrequired

The workflow's id.

stringrequired

published, or a version number.

Headers

Optional headers

stringrequired

Required. The draft revision you last read (the revision from Get Workflow Definition, or meta.revision from your last change). The change applies only if nobody changed the draft since: otherwise it answers 412 with the current revision in error.details.revision. Send it as a strong entity tag ("r_..."): a weak one (W/"...") never matches and answers 412. Without it the request answers 428.

string

Optional. The id of a child organization of your API key's company to act on. Leave it out to act on the key's own company. See Child organizations.

Response fields

versionstring

The version the draft now holds.

triggersarray of objects

The draft triggers now.

idstring
The trigger's id.
namestring
The trigger's display name.
appSlugstring
What starts the workflow: schedule, webhook, runWorkflow (when another workflow calls it), or the app whose event does.
appVersionstring
The app version the trigger is pinned to. "0" for built-in triggers.
actionIdstring
The app event the trigger listens for. Null for a built-in trigger.
isDisabledboolean
True when the trigger is turned off.
isConfiguredboolean
Whether the trigger passed the editor's validation. Null when it was never validated.

stepsarray of objects

The steps, top level first, in execution order. A step that holds others carries them in body (a loop, folder or batch step) or then and else (an If/Else).

idstring
The step's id. Stable across edits; never positional.
numbernumber
The number the editor shows for this step, in execution order. Null for a folder, which the editor does not number.
namestring
The step's display name.
appSlugstring
The app the step runs, or the built-in step type (iterate, ifElse, map, ...).
appVersionstring
The app version the step is pinned to. "0" for built-in step types.
actionIdstring
The app action the step runs. Null for a built-in step type.
functionIdstring
The function this step calls, for a function call step.
parentStepIdstring
The step this one sits inside (a loop, group, folder or if/else). Null at the top level.
slotstring
Where the step sits in its parent: steps (the top level), body (a loop, group or folder), then or else (an if/else lane).
- steps
- body
- then
- else
depthnumber
How deeply the step is nested. 0 at the top level.
isDisabledboolean
True when the step is turned off and runs skip it.
isConfiguredboolean
Whether the step passed the editor's validation (required values set, connection chosen). Null when it was never validated.
bodyarray
Steps nested inside this one, in order. Present when it has any; each has the same keys.
thenarray
Steps nested inside this one, in order. Present when it has any; each has the same keys.
elsearray
Steps nested inside this one, in order. Present when it has any; each has the same keys.