List Executions for Workflow
GET/api/automation/workflows/:workflow/executions
Paginated list of executions for one workflow, newest first.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Filters: filter[status], filter[date_range] (last_hour, last_day, last_week, last_month), filter[search] (matches trigger reference or idempotency key).
Sorts: created_at. Prefix with - for DESC. Default: -created_at.
Pagination: page, per_page (default 10).
Path param: workflow = workflow id.
Filter values use the stored statuses: pending, running, waiting, completed, failed, canceled. Response payloads expose display statuses where completed maps to success and canceled maps to cancelled.
previewMode on the execution is a snapshot taken when the run started — it stays true for runs made while preview mode was on, even after the workflow's own toggle is turned off. Steps skipped by preview are recorded with the input they would have used.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.