Skip to main content
GET
/
v1
/
workflows
/
runs
/
{run_id}
/
steps
/
{node_id}
from retab import Retab

client = Retab()

step = client.workflows.runs.steps.get("run_abc123xyz", "extract-node-1")

if step.handle_outputs:
    for handle_id, payload in step.handle_outputs.items():
        print(f"{handle_id}: {payload}")
{
  "node_id": "extract-node-1",
  "node_type": "extract",
  "node_label": "Extract Data",
  "status": "completed",
  "handle_outputs": {
    "output-0": {
      "invoice_number": "INV-2024-001",
      "total_amount": 1234.56,
      "vendor_name": "Acme Corp"
    }
  },
  "handle_inputs": {
    "input-0": {
      "file_id": "file_123",
      "filename": "invoice.pdf",
      "mime_type": "application/pdf"
    }
  }
}
Get the full output data for a specific step in a workflow run. Use this to retrieve detailed inputs and outputs for a particular node after or during execution.
from retab import Retab

client = Retab()

step = client.workflows.runs.steps.get("run_abc123xyz", "extract-node-1")

if step.handle_outputs:
    for handle_id, payload in step.handle_outputs.items():
        print(f"{handle_id}: {payload}")
{
  "node_id": "extract-node-1",
  "node_type": "extract",
  "node_label": "Extract Data",
  "status": "completed",
  "handle_outputs": {
    "output-0": {
      "invoice_number": "INV-2024-001",
      "total_amount": 1234.56,
      "vendor_name": "Acme Corp"
    }
  },
  "handle_inputs": {
    "input-0": {
      "file_id": "file_123",
      "filename": "invoice.pdf",
      "mime_type": "application/pdf"
    }
  }
}

Authorizations

Api-Key
string
header
required

Path Parameters

run_id
string
required
node_id
string
required

Query Parameters

access_token
string | null

Response

Successful Response

Response containing step output data

node_id
string
required

ID of the node

node_type
string
required

Type of the node

node_label
string
required

Label of the node

status
string
required

Step status

output
Output · object

Step output data

handle_outputs
Handle Outputs · object

Handle outputs keyed by handle ID

handle_inputs
Handle Inputs · object

Handle inputs keyed by handle ID (what this node received)