Create a new run (execute workflow)
Execute a workflow version. Supports input overrides, partial execution, and auto-update of nodes.
POST
/api/runsBody
sessionIdstringrequiredpromptstringclientTurnIdstringresumebooleanmodelIdstringworkflowIdstringworkflowNamestringversionIdstringcheckpointVersionIdstringvaultIdstringspaceIdstringworkflowDataobjectworkflowDataHashstringlastRunIdstringisScheduledbooleanlastRunStatusobjecteditorModeenumOne of: workflow, app, agent, database
moduleContextobjectagentModeenumrequiredOne of: agent, plan, ask
focusedNodestringfocusedNodeContextobjectmentionedNodesstring[]timezonestringappContextstringsandboxSessionIdstringsandboxPreviewUrlstringsandboxDatasetsobject[]imageAttachmentsobject[]fileAttachmentsobject[]autoApprovebooleanRequest
curl
curl -X POST https://platform.trickest.com/api/runs \
-H "Authorization: Bearer $TRICKEST_TOKEN" \
-H "Content-Type: application/json" \
-d '{ }'Responses
201Run created successfully
idstringrequiredworkflow_idstringrequiredstatusenumrequiredOne of: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED, STOPPED, ERROR, PARTIAL_SUCCESS, SCHEDULED, STOPPING
created_datestringrequiredfinished_datestringfinishedbooleancompleted_datestringfleetstringmachinesobject400Bad Request – validation error or malformed input
codestringmessagestring401Unauthorized – missing or expired token
codestringmessagestring500Internal Server Error
codestringmessagestring