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"
}
Workflows
List Workflow Versions
List a workflow’s versions, newest first, for comparison and audit
GET
/
v3
/
workflows
/
{workflow_id}
/
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 requests/min. See Rate limits.
Returns one keyset page of a workflow’s versions, newest first. Follow
An unknown workflow, or one that belongs to another organization, answers
next_cursor until it is null. The response carries no totals and no 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. A run always uses the latest version, and a
PATCH always builds on it. The API cannot run or restore an older version.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"
}
Authorizations
API key issued from app.anyformat.ai/api-key. Send as Authorization: Bearer <key>.
Path Parameters
Query Parameters
Page size, capped at 100.
Required range:
1 <= x <= 100Opaque token from a previous response's next_cursor.
Response
Successful Response
One keyset page of a workflow's versions, newest first.
Item 0 of the first page is the version runs use. Follow next_cursor
until it is null; there are no totals or page numbers.