Skip to main content
GET
/
v1
/
workflows
/
{workflow_id}
/
blocks
/
{block_id}
/
config-history
from retab import Retab

client = Retab()

history = client.workflows.blocks.config_history("wf_abc123xyz", "extract-1")

for entry in history.data:
    print(entry.config_fingerprint, entry.snapshot_versions, entry.run_count)

{
  "data": [
    {
      "config_fingerprint": "fp_2vT9mR4pQ7Xz",
      "block_type": "extract",
      "block_label": "Extract Invoice Fields",
      "config_snapshot": {
        "model": "gpt-5",
        "json_schema": {
          "type": "object",
          "properties": {
            "invoice_number": {"type": "string"},
            "total": {"type": "number"}
          }
        }
      },
      "first_seen_at": "2026-04-08T10:12:00Z",
      "last_seen_at": "2026-04-08T10:12:00Z",
      "snapshot_versions": [2],
      "run_count": 18,
      "is_current": false
    },
    {
      "config_fingerprint": "fp_8KjLmH2qN5Pw",
      "block_type": "extract",
      "block_label": "Extract Invoice Fields",
      "config_snapshot": {
        "model": "gpt-5",
        "json_schema": {
          "type": "object",
          "properties": {
            "invoice_number": {"type": "string"},
            "total": {"type": "number"},
            "currency": {"type": "string"}
          }
        }
      },
      "first_seen_at": "2026-04-12T15:30:00Z",
      "last_seen_at": "2026-04-12T15:30:00Z",
      "snapshot_versions": [3],
      "run_count": 12,
      "is_current": true
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

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.

Return the config-version timeline for a single block. Consecutive workflow publishes in which the block’s config did not change are grouped into a single entry, with the configuration fingerprint, the captured config snapshot, the range of snapshot versions the era spans, and the run count recorded against that era. Returns the canonical { "data": [...], "list_metadata": { "before": null, "after": null } } pagination envelope shared with all Retab list endpoints. Cursor pagination is not yet implemented for this endpoint — list_metadata is always { before: null, after: null }. 
from retab import Retab

client = Retab()

history = client.workflows.blocks.config_history("wf_abc123xyz", "extract-1")

for entry in history.data:
    print(entry.config_fingerprint, entry.snapshot_versions, entry.run_count)

{
  "data": [
    {
      "config_fingerprint": "fp_2vT9mR4pQ7Xz",
      "block_type": "extract",
      "block_label": "Extract Invoice Fields",
      "config_snapshot": {
        "model": "gpt-5",
        "json_schema": {
          "type": "object",
          "properties": {
            "invoice_number": {"type": "string"},
            "total": {"type": "number"}
          }
        }
      },
      "first_seen_at": "2026-04-08T10:12:00Z",
      "last_seen_at": "2026-04-08T10:12:00Z",
      "snapshot_versions": [2],
      "run_count": 18,
      "is_current": false
    },
    {
      "config_fingerprint": "fp_8KjLmH2qN5Pw",
      "block_type": "extract",
      "block_label": "Extract Invoice Fields",
      "config_snapshot": {
        "model": "gpt-5",
        "json_schema": {
          "type": "object",
          "properties": {
            "invoice_number": {"type": "string"},
            "total": {"type": "number"},
            "currency": {"type": "string"}
          }
        }
      },
      "first_seen_at": "2026-04-12T15:30:00Z",
      "last_seen_at": "2026-04-12T15:30:00Z",
      "snapshot_versions": [3],
      "run_count": 12,
      "is_current": true
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
workflow_id
string
required
​
block_id
string
required

Response

Successful Response

​
config_fingerprint
string
required
​
first_seen_at
string<date-time>
required
​
last_seen_at
string<date-time>
required
​
block_type
string
default:""
​
block_label
string
default:""
​
config_snapshot
Config Snapshot · object
​
snapshot_versions
integer[]
​
run_count
integer
default:0
​
is_current
boolean
default:false