---
title: "List workflow revisions"
method: GET
path: "/workflows/{workflow_id}/revisions"
tags: ["workflows"]
---

# List workflow revisions

`GET /workflows/{workflow_id}/revisions`

Returns revision metadata (id, number, author, message, bytes, sha256, created_at) for the workflow, in reverse-chronological order. Use the `before` cursor to paginate older revisions.

## Path parameters

- `workflow_id` string, uuid, required — workflow identifier

## Query parameters

- `limit` integer
- `before` integer — cursor: return revisions older than this revision number

## Response `200`

OK

- WorkflowListRevisionsResponse — Returned from GET /workflows/:id/revisions.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `revisions` WorkflowRevisionSummary[], nullable, required — Page of revision summaries, newest-first.
    - `author_user_id` string, uuid, required — User who saved the revision.
    - `bytes` integer, required — Size of the code source in bytes.
    - `created_at` string, date-time, required — When the revision was saved.
    - `id` string, uuid, required — Revision identifier.
    - `message` string, nullable, required — Optional commit-style message.
    - `revision` integer, required — Monotonic revision number, starting at 1.
    - `sha256` string, required — SHA-256 of the code source.

## Other responses

- `default` — Error

## Changes

> 18 revisions in range; 5 could not be searched.

- **2026-07-23** `5a989777701c` — 1 breaking
  - for the `path` request parameter `workflow_id`, the type/format was changed from `string`/`` to `string`/`uuid`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/workflows/:workflow_id/revisions/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/8a66f81813b3/schema)