List Workflows
GET/api/automation/workflows
Paginated list of automation workflows with run statistics (total, successful, and failed runs, average duration, and last run).
settings:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
stats.failedRuns counts every failed run since the workflow was created; stats.recentFailedRuns counts only those in the last stats.recentFailureWindowDays days (7), so a workflow that is still failing can be told apart from one that failed long ago.
Filters: filter[status] (draft, published, disabled), filter[category], filter[trigger_type] (event, schedule, manual, webhook, pre_dispatch), filter[search] (matches name or description).
Sorts: id, name, created_at, updated_at. Prefix with - for descending. Default: -updated_at. Sort by id to list workflows in the order the dispatcher evaluates them — relevant for pre_dispatch routing workflows, where the first matching workflow routes the order and the rest are skipped.
Pagination: page, per_page (default 10).
Each row carries previewMode — true when the workflow is in preview mode and its runs skip every state-changing step.
Request
Responses
- 200
- 401
- 403
- 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.
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.