Skip to main content
GET
/
v1
/
workflows
/
{workflow_id}
/
experiments
/
eligible-blocks
from retab import Retab

client = Retab()

result = client.workflows.experiments.list_eligible_blocks(
    workflow_id="wf_abc123",
)
for block in result.blocks:
    print(block.block_id, block.block_type, block.experiment_count)

{
  "blocks": [
    {
      "block_id": "extract-invoice",
      "block_label": "Extract Invoice Fields",
      "block_type": "extract",
      "experiment_count": 2,
      "drifted_experiment_count": 0,
      "stale_experiment_count": 1,
      "latest_run_at": "2026-05-02T09:00:00Z",
      "mean_score": 0.84
    }
  ]
}

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 blocks in the current draft that can host experiments — extract, split, classifier, and for_each blocks configured with map_method="split_by_key". Each row also carries roll-ups for the experiments already attached to that block (counts, mean score, latest run). Useful for building a dashboard “add experiment” picker without separately listing blocks and then filtering client-side. 
from retab import Retab

client = Retab()

result = client.workflows.experiments.list_eligible_blocks(
    workflow_id="wf_abc123",
)
for block in result.blocks:
    print(block.block_id, block.block_type, block.experiment_count)

{
  "blocks": [
    {
      "block_id": "extract-invoice",
      "block_label": "Extract Invoice Fields",
      "block_type": "extract",
      "experiment_count": 2,
      "drifted_experiment_count": 0,
      "stale_experiment_count": 1,
      "latest_run_at": "2026-05-02T09:00:00Z",
      "mean_score": 0.84
    }
  ]
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
workflow_id
string
required

Query Parameters

​
access_token
string | null

Response

Successful Response

​
blocks
EligibleBlockSummary · object[]
required