Skip to main content
GET
List a flow's edit history
Every save of the flow, newest first — what changed, who changed it and from which surface. The first entry is the version the flow is currently on.
changed_fields tells a canvas-only move (["ui"]) apart from a graph edit (["config"]), which is what makes a long history readable when you are looking for the change that broke something.

Headers

x-apikey
string
required

API Key for authentication

Path Parameters

flow_id
string
required

Flow identifier, e.g. fl_ab12cd34

Query Parameters

page
integer
default:1
limit
integer
default:50

Response

Versions, newest first

number
integer
required

1-based, monotonic within one flow.

name
string
required
description
string
required
changed_fields
string[]
required

Which of name, description, config, ui differ from the previous version — so a canvas-only move can be told from a graph edit.

source
enum<string>
required

Where the edit came from.

Available options:
ui,
api,
mcp,
admin,
system
created_at
string
required
created_by
string | null
required

Email of the author, or null for edits made outside a user session.

restored_from
integer | null

Set when this version was produced by a rollback.