---
title: "List pipeline versions"
method: GET
path: "/pipelines/{pipelineId}/versions"
tags: ["pipeline-versions"]
---

# List pipeline versions

`GET /pipelines/{pipelineId}/versions`

Lists all available pipeline versions in a user context. Append `workspaceId` to list pipeline versions in a workspace context.

## Path parameters

- `pipelineId` integer, required

## Query parameters

- `workspaceId` integer
- `max` integer
- `offset` integer
- `search` string
- `isPublished` boolean

## Response `200`

OK

- ListPipelineVersionsResponse
  - `totalSize` integer
  - `versions` PipelineDbDto[]
    - `computeEnv` ComputeEnvDbDto
      - `id` string
      - `name` string
      - `platform` string
      - `region` string
    - `deleted` boolean
    - `description` string, nullable
    - `icon` string, nullable
    - `labels` LabelDbDto[], nullable
      - `dateCreated` string, date-time
      - `id` integer
      - `isDefault` boolean
      - `isDynamic` boolean
      - `isInterpolated` boolean
      - `name` string
      - `resource` boolean
      - `value` string
    - `lastUpdated` string, date-time
    - `name` string
    - `optimizationId` string, nullable
    - `optimizationStatus` 'OPTIMIZED' | 'OPTIMIZABLE' | 'UNAVAILABLE'
    - `optimizationTargets` string, nullable
    - `orgId` integer, nullable
    - `orgName` string, nullable
    - `pipelineId` integer
    - `repository` string
    - `userFirstName` string, nullable
    - `userId` integer
    - `userLastName` string, nullable
    - `userName` string
    - `version` PipelineVersionFullInfoDto
      - `creatorAvatarUrl` string
      - `creatorFirstName` string
      - `creatorLastName` string
      - `creatorUserId` integer
      - `creatorUserName` string
      - `dateCreated` string, date-time
      - `hash` string
      - `id` string
      - `isDefault` boolean
      - `lastUpdated` string, date-time
      - `name` string
    - `visibility` string, nullable
    - `workspaceId` integer, nullable
    - `workspaceName` string, nullable

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

## Changes

> 14 revisions in range; 1 not diffed.

- **2026-08-27** `97f7655d105a` — 16 breaking, 4 warning, 5 info
  - the response property `versions/items/computeEnv` became nullable for the status `200`
  - the response property `versions/items/description` became nullable for the status `200`
  - the response property `versions/items/icon` became nullable for the status `200`
  - the response property `versions/items/labels` became nullable for the status `200`
  - …21 more
- **2026-03-10** `49c99a6944de` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/pipelines/:pipelineId/versions/get.md)

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/97f7655d105a/schema)