---
title: "List Workflow Versions"
method: GET
path: "/v2/workflows/{workflow_id}/versions"
tags: ["Workflow API"]
---

# List Workflow Versions

`GET /v2/workflows/{workflow_id}/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.

## Path parameters

- `workflow_id` string, required — The ID of the workflow whose versions to list.

## Query parameters

- `includeUnpublishedDrafts` boolean — If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions).
- `pageSize` integer — Maximum number of results to return. Default is 1000, maximum is 2000.
- `pageToken` string — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvflowPublicapiListWorkflowVersionsResponse
  - `data` SvflowPubapimodelsWorkflowVersion[] — The list of workflow versions, newest first.
    - `id` string — The ID of this workflow version. Pass to StartWorkflowRun as workflow_version_id to run this specific version (works for both published versions and unpublished drafts).
    - `workflowId` string — The ID of the workflow this version belongs to.
    - `name` string — Workflow name at this version (can differ across versions).
    - `description` string — Workflow description at this version.
    - `content` string — The TypeScript content of the workflow at this version.
    - `createdByUserId` string — User who created this version.
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `publishedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `isPublished` boolean — Whether this version has ever been published.
  - `nextPageToken` string, nullable — Token for retrieving the next page of results. Empty if no more results.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)