Skip to main content
GET
List flow versions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

flowId
string
required

The flow's internal id, e.g. clx9z8y7x6w5v4u3t2s1. Get it from List flows (the id field of each flow). It is NOT the publicId slug that appears in a flow's public URL: a slug answers 404 here. A flow your token cannot reach answers 404, indistinguishable from one that does not exist.

Query Parameters

limit
integer
default:20

How many entries to return, from 1 to 100. Defaults to 20. Keep it small when excludeContent is not true.

Required range: 1 <= x <= 100
cursor
string

Where to resume: the nextCursor of the previous page. Omit for the first page.

excludeContent
boolean

When true, entries come without the snapshot's flow content — just who, when and which origin. Send true whenever you are listing versions; leave it out only to read a single snapshot with historyId. Without it every entry carries a complete copy of the flow.

historyId
string

Return only this snapshot, by its id from an earlier listing of this flow's history. A snapshot of another flow answers an empty list.

Response

One page of snapshots, newest first.

One page of a flow's version history.

history
object[]
required

The snapshots on this page, newest first.

nextCursor
string | null

Pass as cursor to read the next page. Null on the last page.

totalCount
integer

How many snapshots the flow has (or 1 when historyId was sent).