Skip to main content
GET
/
v1
/
workflows
/
blocks
/
versions
List Block Versions
curl --request GET \
  --url https://api.retab.com/v1/workflows/blocks/versions \
  --header 'Api-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "block_id": "<string>",
      "workflow_id": "<string>",
      "workflow_version_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "label": "",
      "position_x": 0,
      "position_y": 0,
      "width": 123,
      "height": 123,
      "parent_id": "<string>",
      "config": {},
      "resolved_schemas": {},
      "config_hash": ""
    }
  ],
  "list_metadata": {
    "before": "<string>",
    "after": "<string>"
  }
}
List immutable workflow block 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/blocks/versions?workflow_id=wf_abc123" \
  -H "Api-Key: $RETAB_API_KEY"

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
workflow_id
string
required
​
block_id
string | null

Filter by stable block ID

​
workflow_version_id
string | null

Filter by workflow version ID

​
before
string | null

Block version cursor before

​
after
string | null

Block version cursor after

​
limit
integer
default:50

Maximum number of block versions to return

Required range: 1 <= x <= 100

Response

Successful Response

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

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

Boundary resource IDs for page navigation.