Sign in

v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Workflow API

List Workflow Versions

List the version history of a workflow. By default returns only published versions (newest first). Pass include_unpublished_drafts=true to also include unpublished drafts. Each version's id can be passed as workflow_version_id to StartWorkflowRun to run that specific version.

get/v2/workflows/{workflow_id}/versions

Path parameters

workflow_idstring required

The ID of the workflow whose versions to list.

Query parameters

includeUnpublishedDraftsboolean

If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).

If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).

pageSizeinteger

Maximum number of results to return. Default is 1000, maximum is 2000.

Maximum number of results to return. Default is 1000, maximum is 2000.

pageTokenstring

Token for pagination. Leave empty for the first request.

Token for pagination. Leave empty for the first request.

Response

Success

nextPageTokenstring nullable

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