> ## Documentation Index > Fetch the complete documentation index at: https://docs.serval.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /sections/api-reference/openapi-spec-v2.yaml get /v2/workflows/{workflow_id}/versions openapi: 3.1.0 info: title: Serval Public API description: Serval Public API contact: name: Serval url: https://serval.com email: support@serval.com license: name: Serval License url: https://serval.com/license version: 2.0.0 servers: - url: https://public.api.serval.com security: - BearerAuth: [] tags: - name: Access Policy API - name: Access Policy Approval Procedure API - name: Access Profile API - name: Access Relationship API - name: Access Request API - name: Agent Session API - name: App Instance API - name: App Resource API - name: App Resource Role API - name: Approval Delegation API - name: Approval Request API - name: Audit Log API - name: Change Blackout API - name: Change Model API - name: Custom Field API - name: Custom Service API - name: Entity API - name: Entity Field Mapping API - name: Entity Ingestion Config API - name: Entity Type API - name: Folder API - name: Group API - name: Guidance API - name: Help Agent API - name: Journey API - name: Knowledge API - name: Knowledge Base API - name: Report API - name: SLA API - name: Schedule API - name: Tag API - name: Team API - name: Team User API - name: Ticket API - name: Topic API - name: User API - name: User Relationship API - name: Workflow API - name: Workflow Approval Procedure API - name: Workflow Run API paths: /v2/workflows/{workflow_id}/versions: get: tags: - Workflow API summary: List Workflow Versions description: >- 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. operationId: svrelay.publicv2.PublicAPIServiceV2.ListWorkflowVersions parameters: - name: workflow_id in: path required: true schema: type: string title: workflow_id description: The ID of the workflow whose versions to list. - name: includeUnpublishedDrafts in: query description: >- If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions). schema: type: boolean title: include_unpublished_drafts description: >- If true, include unpublished draft versions alongside published ones. Default false (only the complete history of published versions). - name: pageSize in: query description: >- Maximum number of results to return. Default is 1000, maximum is 2000. schema: type: integer title: page_size format: int32 description: >- Maximum number of results to return. Default is 1000, maximum is 2000. - name: pageToken in: query description: Token for pagination. Leave empty for the first request. schema: type: string title: page_token description: Token for pagination. Leave empty for the first request. responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/svflow.publicapi.ListWorkflowVersionsResponse default: description: Error content: application/json: schema: $ref: '#/components/schemas/connect.error' security: - BearerAuth: [] components: schemas: svflow.publicapi.ListWorkflowVersionsResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/svflow.pubapimodels.WorkflowVersion' title: data description: The list of workflow versions, newest first. x-stainless-terraform-configurability: optional nextPageToken: type: string title: next_page_token description: >- Token for retrieving the next page of results. Empty if no more results. nullable: true x-stainless-terraform-configurability: optional title: ListWorkflowVersionsResponse additionalProperties: false connect.error: type: object properties: code: type: string examples: - not_found enum: - canceled - unknown - invalid_argument - deadline_exceeded - not_found - already_exists - permission_denied - resource_exhausted - failed_precondition - aborted - out_of_range - unimplemented - internal - unavailable - data_loss - unauthenticated description: >- The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. x-stainless-terraform-configurability: optional message: type: string description: >- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. x-stainless-terraform-configurability: optional detail: $ref: '#/components/schemas/google.protobuf.Any' x-stainless-terraform-configurability: optional title: Connect Error additionalProperties: true description: >- Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation svflow.pubapimodels.WorkflowVersion: type: object properties: id: type: string title: id description: |- 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). readOnly: true x-stainless-terraform-configurability: computed workflowId: type: string title: workflow_id description: The ID of the workflow this version belongs to. readOnly: true x-stainless-terraform-configurability: computed name: type: string title: name description: Workflow name at this version (can differ across versions). readOnly: true x-stainless-terraform-configurability: computed description: type: string title: description description: Workflow description at this version. readOnly: true x-stainless-terraform-configurability: computed content: type: string title: content description: The TypeScript content of the workflow at this version. readOnly: true x-stainless-terraform-configurability: computed createdByUserId: type: string title: created_by_user_id description: User who created this version. readOnly: true x-stainless-terraform-configurability: computed createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at description: When this version was first saved (always set). readOnly: true x-stainless-terraform-configurability: computed publishedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: published_at description: >- When this version was published. Unset for draft (unpublished) versions. nullable: true readOnly: true x-stainless-terraform-configurability: computed isPublished: type: boolean title: is_published description: Whether this version has ever been published. readOnly: true x-stainless-terraform-configurability: computed title: WorkflowVersion additionalProperties: false google.protobuf.Any: type: object properties: type: type: string x-stainless-terraform-configurability: optional value: type: string format: binary x-stainless-terraform-configurability: optional debug: type: object additionalProperties: true x-stainless-terraform-configurability: optional additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. google.protobuf.Timestamp: type: string format: date-time description: A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z"). securitySchemes: BearerAuth: type: http scheme: bearer ````