---
title: "List a flow's edit history"
method: GET
path: "/external/v1/flows/{flow_id}/versions"
tags: ["Flows"]
---

# List a flow's edit history

`GET /external/v1/flows/{flow_id}/versions`

## Request

- Base URL: `https://api.databar.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.databar.ai/external/v1/flows/{flow_id}/versions`
- Auth: API key in header `x-apikey`

Every save of this flow, newest first: what changed, who changed it and
from which surface.

## Path parameters

- `flow_id` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- FlowVersionOut[]
  - `number` integer, required
  - `name` string, required
  - `description` string, required
  - `changed_fields` string[], required
  - `source` string, required: Where the edit came from: ui, api, mcp, admin or system.
  - `created_at` string, required
  - `created_by` string, nullable, required
  - `restored_from` integer, nullable: Version this one was restored from, if it came from a rollback.

---

[API](https://skmtc.dev/databar/apis/external-api.md) - [All operations](https://skmtc.dev/databar/apis/external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/databar/apis/external-api/revisions/efe15f8bb9bb?raw)
