List Workflow Versions

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/versions/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/versions/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

cursor = None
while True:
    params = {"limit": 20, **({"cursor": cursor} if cursor else {})}
    page = requests.get(url, headers=headers, params=params).json()
    for version in page["items"]:
        print(version["version_id"], version["version"], version["created_at"])
    cursor = page["next_cursor"]
    if cursor is None:
        break

{
  "items": [
    {
      "version_id": "FGaV4I2JAA",
      "version": "1.2.0",
      "created_at": "2026-07-03T09:00:00.000Z"
    },
    {
      "version_id": "AbCdEfGhIj",
      "version": "1.1.0",
      "created_at": "2026-07-02T09:00:00.000Z"
    }
  ],
  "next_cursor": null
}

{
  "error": "Resource not found",
  "detail": "Workflow not found",
  "error_code": "NOT_FOUND",
  "retryable": false,
  "request_id": "a1b2c3d4e5f67890abcdef1234567890"
}

Rate limit tier: general (600 req/min) — see Rate limits. Returns one keyset page of a workflow’s versions, newest first. Follow next_cursor until it is null — there are no totals or page numbers (see Pagination). Every save that changes the graph mints a new version; item 0 of the first page is the version runs use. Each item carries the version_id and the display number major.minor.patch. To read a version’s graph, pass its version_id as ?version= on GET /v3/workflows/{workflow_id}/.

Versions are read-only. They exist for comparison and audit. A run always uses the latest version, and a PATCH always builds on the latest version — there is no way to run or restore an older version through the API.

An unknown workflow, or one that belongs to another organization, answers 404 with error_code: NOT_FOUND.

Compare two versions

List the versions, read two of them, and diff the field descriptions of the extract node:

Python (requests)

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
base = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

versions = requests.get(f"{base}versions/", headers=headers).json()["items"]
latest, previous = versions[0], versions[1]


def field_descriptions(version_id):
    workflow = requests.get(base, headers=headers, params={"version": version_id}).json()
    extract = next(node for node in workflow["nodes"] if node["type"] == "extract")
    return {f["name"]: f["description"] for f in extract["extraction_schema"]["fields"]}


before = field_descriptions(previous["version_id"])
after = field_descriptions(latest["version_id"])
for name in sorted(before.keys() | after.keys()):
    if before.get(name) != after.get(name):
        print(f"{name}: {before.get(name)!r} -> {after.get(name)!r}")

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/versions/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/versions/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

cursor = None
while True:
    params = {"limit": 20, **({"cursor": cursor} if cursor else {})}
    page = requests.get(url, headers=headers, params=params).json()
    for version in page["items"]:
        print(version["version_id"], version["version"], version["created_at"])
    cursor = page["next_cursor"]
    if cursor is None:
        break

{
  "items": [
    {
      "version_id": "FGaV4I2JAA",
      "version": "1.2.0",
      "created_at": "2026-07-03T09:00:00.000Z"
    },
    {
      "version_id": "AbCdEfGhIj",
      "version": "1.1.0",
      "created_at": "2026-07-02T09:00:00.000Z"
    }
  ],
  "next_cursor": null
}

{
  "error": "Resource not found",
  "detail": "Workflow not found",
  "error_code": "NOT_FOUND",
  "retryable": false,
  "request_id": "a1b2c3d4e5f67890abcdef1234567890"
}

Overview

Workflows

Upload

Document packets

Runs

Parse

Knowledge

Evals

SDKs and tools

API v2 (deprecated)

List Workflow Versions

Compare two versions

​Compare two versions

Compare two versions