Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
List runs (executions)

List runs (executions)

List workflow runs/executions with optional filtering by space, ordering, pagination.

GET/api/runs
Query parameters
pageintegerrequireddefault: 1
page_sizeintegerrequired
orderingstring
vaultstring
spacestring
statusstring
workflowobject

Request

curl
curl -X GET https://trickest.io/api/runs \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200Paginated list of runs
resultsobject[]required

countinteger
nextstring
previousstring
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousRolesRemove a vault role from a user.RunsNextCreate a new run (execute workflow)