Skip to main content
GET
/
v1
/
workflows
/
versions
List Workflow Versions
curl --request GET \
  --url https://api.retab.com/v1/workflows/versions \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "workflow_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "blocks": [],
      "edges": [],
      "block_version_ids": [],
      "edge_version_ids": []
    }
  ],
  "list_metadata": {
    "before": "<string>",
    "after": "<string>"
  }
}
List immutable workflow graph versions.
Python
workflow_id = "wf_abc123"
print(workflow_id)
TypeScript
const workflowId = "wf_abc123";
console.log(workflowId);
Go
workflowID := "wf_abc123"
_ = workflowID
Java
String workflowId = "wf_abc123";
System.out.println(workflowId);
cURL
curl "https://api.retab.com/v1/workflows/versions?workflow_id=wf_abc123" \
  -H "Authorization: Bearer $RETAB_API_KEY"

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
workflow_id
string
required

Workflow whose versions to list

​
before
string | null

Workflow version cursor before

​
after
string | null

Workflow version cursor after

​
limit
integer
default:50

Maximum number of versions to return

Required range: 1 <= x <= 100

Response

Successful Response

A page of WorkflowGraphVersion resources. data holds the items and list_metadata carries the before/after cursors; pass after to fetch the next page.

​
data
WorkflowGraphVersion · object[]
required
​
list_metadata
ListMetadata · object
required

Boundary resource IDs for page navigation.