---
title: "List workflow versions"
method: GET
path: "/agents/v2/workflows/{workflowId}/versions"
tags: ["Workflow Versions"]
---

# List workflow versions

`GET /agents/v2/workflows/{workflowId}/versions`

## Request

- Base URL: `https://odyssey.asteroid.ai`
- URL: `https://odyssey.asteroid.ai/agents/v2/workflows/{workflowId}/versions`
- Auth: API key in header `X-Api-Key`

List every version of the workflow with lightweight metadata

## Path parameters

- `workflowId` string, uuid, required

## Response `200`

The request has succeeded.

- WorkflowsVersionRef[]
  - `author` string: The email of the user who created this workflow.
  - `createdAt` string, date-time, required
  - `id` string, uuid, required
  - `isDeletable` boolean, required: Whether this snapshot can be deleted (not published and never executed)
  - `isPublished` boolean, required: Whether this is the workflow's published version (the API default). At most one version per workflow is published.
  - `parentId` string, uuid
  - `version` integer, required: The monotonic per-workflow version number.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `500`: Server error

---

[API](https://skmtc.dev/asteroid/apis/agent-service.md) - [All operations](https://skmtc.dev/asteroid/apis/agent-service/llms.txt) - [OpenAPI document](https://skmtc.dev/asteroid/apis/agent-service/revisions/ccc134d1d510?raw)