Test Workflow Step
Run one step of the workflow's draft on its own, exactly as Run in the editor does: with its saved configuration and connection, the saved sample outputs of the steps it references, and real side effects (a create step creates). The output is saved as the step's sample, which later steps' references and their tests read; a step that fails answers status failed with the error, not an HTTP error. A Loop, Wait, Flow control, Respond to webhook, Continue or Break step only runs inside a workflow run, and a Run workflow step, which queues another workflow's run, is not tested on its own. A function step's test checks the connections of the function's own steps too. Saving the sample changes the draft's revision. If-Match is optional on this route, unlike the draft's other changes, and recommended: send the revision you last read and a stale one is refused with 412 before the step runs; left out, the step runs on whatever the draft is now. Use meta.revision on your next change.
Path
The workflow's id, from List Workflows.
The step's id, from List Workflow Steps or Get Workflow Definition.
Headers
Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See Organizations.
Body
The environment to run in, from List Environments. Defaults to the company's default environment.
The environment to run in, from List Environments. Left out, the company's default environment.
Response fields
successbooleanTrue when the step ran without an error: the same flag List Run Steps and Get a Run Step answer for a step of a run.
statusstringsucceeded or failed: the step's outcome, the same as success. It is not a run status: a run's status (finished, failed, ...) says where the whole run is.
succeededfailed
outputobjectThe first records of the output (a JSON array as the step answered it), capped at 200 records and about 60 KB. Empty when there is no sample.
totalnumberHow many records the output had in all. Null when there is no sample.
truncatedbooleanTrue when output holds fewer records than total: the rest were left out of the sample, not lost. Later steps still learn their fields from the records kept.
truncatedBystringWhy output stopped short of total. Null unless truncated is true.
recordsIt reached the 200-record cap.sizeIts records reached about 60 KB first, so it keeps fewer than 200.
outputFieldsarray of objectsThe fields of the output records, learned from the sample and offered to later steps.
keystringThe field's path in each record: dotted, with [] marking an array (lines[].sku). Reference it as {{ steps.<stepId>.output[0].<key> }}.
typestringIts type as seen in the sample: string, number, boolean, object, date, a type with [] for an array, or mixed.
errorobjectWhy the run failed. Null unless status is failed.
codestringThe runtime's error code (ARGUMENTS_MISSING, 401_UNAUTHORIZED, DEFAULT, ...).
messagestringWhat the code means, for a person. What the app answered, if anything, is in output.
statusnumberThe HTTP status the app answered, when it answered one.
savedOndateWhen the sample was saved. Null when there is none.
revisionstringThe draft's revision after the sample was saved (a sample is part of the step): send it in If-Match on your next change to the draft.
durationMsnumberHow long the step took to run, in milliseconds.