Create a new run (execute workflow)

Execute a workflow version. Supports input overrides, partial execution, and auto-update of nodes.

POST/api/runs

Body

workflow_version_infostringrequired

machinesobjectrequired

fleetstringrequired

use_static_ipsbooleandefault: false

vaultstringrequired

inputsobject

save_input_changesbooleandefault: false

workflow_idstringrequired

agent_session_idstring

partial_execution_configobject

use_latest_versionbooleandefault: false

Request

curl

curl -X POST https://trickest.io/api/runs \
  -H "Authorization: Token $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

201Run created successfully

idstringrequired

workflow_idstringrequired

statusenumrequired

One of: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED, STOPPED, ERROR, PARTIAL_SUCCESS, SCHEDULED, STOPPING

created_datestringrequired

finished_datestring

finishedboolean

completed_datestring

fleetstring

machinesobject

400Bad Request – validation error or malformed input

codestringrequired

messagestringrequired

detailsobject