Skip to main content

Get Workflow Run History

GET 
/api/v1/workflows/:workflow_id/runs

Return a chronological (evaluated_at desc) page of THIS workflow's evaluations.

Two sources, both scoped to the workflow:

  1. WorkflowEvaluationTrace, so SKIPPED events surface alongside fired runs, answering "why didn't my automation fire?". By default, trace rows about geofences this workflow's trigger does not target are dropped: the matcher writes one row per considered workflow, so an unscoped feed is workspace-wide noise that repeats identically under every other workflow. Pass include_other_geofences=true to get them back — that is the view that answers "the van entered zone A, why didn't my zone-B workflow fire?".
  2. WorkflowExecution rows that no trace accounts for (manual runs, and runs that predate trace capture), so the workflow's real runs are never missing from its own run history.

Each entry includes evaluated_at, trigger reference, matched/skip_reason, and for matched entries the joined execution detail + per-action delivery outcomes.

Request​

Responses​

OK

Response Headers
    X-Limit

    Maximum number of returned items

    X-Offset

    Zero-based result offset

    X-Has-More

    Whether another page is available