Skip to main content
GET
/
api
/
v2
/
public
/
workflow
/
versions
/
:workflow_id
curl -X GET "https://app.refold.ai/api/v2/public/workflow/versions/{workflow_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

{
  "docs": [
    { "version": 2, "_id": "6a049fb6803e7107e7895eed", "createdAt": "2026-05-13T15:58:46.103Z" },
    { "version": 1, "_id": "69fdfe21957a1b5597aa04bd", "createdAt": "2026-05-08T15:15:45.616Z" }
  ],
  "totalDocs": 2,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}
List the published versions (snapshots) of a workflow, paginated, newest first. Each publish creates a new version.
This authenticates as a linked account, so it lists versions of that account’s private workflow.

​
Authentication

This endpoint is scoped to a linked account, so it accepts either authentication method. Option 1 — API key
​
x-api-key
string
Your Refold API key.
​
linked_account_id
string
The linked account that owns the workflow.
Option 2 — Session token
​
Authorization
string
Session token. Format: Bearer YOUR_SESSION_TOKEN

​
Path Parameters

​
workflow_id
string
required
The workflow ID.

​
Query Parameters

​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Page size.

​
Response

Returns a paginated envelope of version snapshots, newest first.
​
docs
array
Versions, each with version, _id, and createdAt.
​
totalDocs
integer
Total versions.
​
hasNextPage
boolean
Whether another page follows.
{
  "docs": [
    { "version": 2, "_id": "6a049fb6803e7107e7895eed", "createdAt": "2026-05-13T15:58:46.103Z" },
    { "version": 1, "_id": "69fdfe21957a1b5597aa04bd", "createdAt": "2026-05-08T15:15:45.616Z" }
  ],
  "totalDocs": 2,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}

curl -X GET "https://app.refold.ai/api/v2/public/workflow/versions/{workflow_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"