v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Workflow Run API

List Workflow Runs

List all workflow runs for a team, ordered by created_at desc. For filtering (by workflow_id, status, user, time range, or linked ticket), use POST /v2/workflow-runs/search instead.

get/v2/workflow-runs

Query parameters

teamIdstring

The ID of the team. Required.

The ID of the team. Required.

pageSizeinteger

Maximum number of results to return. Default is 50, maximum is 200. Larger values are silently coerced server-side; the actual value used is returned in the X-Served-Page-Size response header.

Maximum number of results to return. Default is 50, maximum is 200. Larger values are silently coerced server-side; the actual value used is returned in the X-Served-Page-Size response header.

pageTokenstring

Token for pagination. Leave empty for the first request.

Token for pagination. Leave empty for the first request.

includeOutputboolean

When true (default), each returned run includes its output field (the full workflow result). For multi-row list responses this can be megabytes per row — set to false if you only need run metadata; you can then fetch full output per-run via GetWorkflowRun. Strongly recommended false for any caller that does not need output.

When true (default), each returned run includes its output field (the full workflow result). For multi-row list responses this can be megabytes per row — set to false if you only need run metadata; you can then fetch full output per-run via GetWorkflowRun. Strongly recommended false for any caller that does not need output.

Response

Success

nextPageTokenstring nullable

Token for retrieving the next page of results. Empty if no more results.