Skip to main content
GET
/
v1
/
workflows
/
blocks
/
versions
from retab import Retab

client = Retab()

versions = client.workflows.blocks.list_versions(
    workflow_id="wrk_abc123",
    block_id="blk_extract",
)
print(versions.data[0].config)

{
  "data": [
    {
      "id": "<string>",
      "block_id": "<string>",
      "workflow_id": "<string>",
      "organization_id": "<string>",
      "environment_id": "<string>",
      "workflow_version_id": "<string>",
      "label": "",
      "position_x": 0,
      "position_y": 0,
      "width": 123,
      "height": 123,
      "parent_id": "<string>",
      "config": {},
      "field_ref_snapshot": {},
      "resolved_schemas": {},
      "config_hash": "",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "list_metadata": {
    "before": "<string>",
    "after": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.retab.com/llms.txt

Use this file to discover all available pages before exploring further.

List immutable block versions for one workflow. Use block_id to narrow the list to one logical block, or workflow_version_id to inspect the blocks that belong to one workflow version. 
from retab import Retab

client = Retab()

versions = client.workflows.blocks.list_versions(
    workflow_id="wrk_abc123",
    block_id="blk_extract",
)
print(versions.data[0].config)

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

​
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.