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

client = Retab()

block_executions = client.workflows.blocks.executions.list(
    run_id="run_abc123xyz",
    block_id="blk_extract_1",
)
import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

const block_executions = await client.workflows.blocks.executions.list({
  runId: "run_abc123xyz",
  blockId: "blk_extract_1",
});
block_executions, err := client.Workflows.Blocks.Executions.List(ctx, &retab.WorkflowBlockExecutionsListParams{
	RunID:   ptr("run_abc123xyz"),
	BlockID: ptr("blk_extract_1"),
	Limit:   ptr(20),
})
require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

block_executions = client.workflows.blocks.executions.list(
  run_id: 'run_abc123xyz',
  block_id: 'blk_extract_1',
)
use retab::resources::workflow_block_executions::ListParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    let block_executions = client
        .workflows()
        .blocks()
        .executions()
        .list(ListParams::new("run_abc123xyz", "blk_extract_1"))
        .await?;

    println!("{}", block_executions.data.len());
    Ok(())
}
<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

$result = $client->workflows()->blocks()->executions()->list(
    runId: 'run_abc123',
    blockId: 'blk_extract_1',
);
print_r($result);
using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

var result = await client.Workflows.Blocks.Executions.ListAsync(new WorkflowBlockExecutionsListOptions());
Console.WriteLine(result);
import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var result = client.workflows().blocks().executions().list("run_abc123", "block_abc123", null, null, 10L, null);
    System.out.println(result);
  }
}
curl -X 'GET' \
  'https://api.retab.com/v1/workflows/blocks/executions?run_id=run_abc123xyz&block_id=blk_extract_1' \
  -H 'Authorization: Bearer <your-api-key>'
{
  "data": [],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
List workflow block executions for one run and block.
from retab import Retab

client = Retab()

block_executions = client.workflows.blocks.executions.list(
    run_id="run_abc123xyz",
    block_id="blk_extract_1",
)
import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

const block_executions = await client.workflows.blocks.executions.list({
  runId: "run_abc123xyz",
  blockId: "blk_extract_1",
});
block_executions, err := client.Workflows.Blocks.Executions.List(ctx, &retab.WorkflowBlockExecutionsListParams{
	RunID:   ptr("run_abc123xyz"),
	BlockID: ptr("blk_extract_1"),
	Limit:   ptr(20),
})
require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

block_executions = client.workflows.blocks.executions.list(
  run_id: 'run_abc123xyz',
  block_id: 'blk_extract_1',
)
use retab::resources::workflow_block_executions::ListParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    let block_executions = client
        .workflows()
        .blocks()
        .executions()
        .list(ListParams::new("run_abc123xyz", "blk_extract_1"))
        .await?;

    println!("{}", block_executions.data.len());
    Ok(())
}
<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

$result = $client->workflows()->blocks()->executions()->list(
    runId: 'run_abc123',
    blockId: 'blk_extract_1',
);
print_r($result);
using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

var result = await client.Workflows.Blocks.Executions.ListAsync(new WorkflowBlockExecutionsListOptions());
Console.WriteLine(result);
import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var result = client.workflows().blocks().executions().list("run_abc123", "block_abc123", null, null, 10L, null);
    System.out.println(result);
  }
}
curl -X 'GET' \
  'https://api.retab.com/v1/workflows/blocks/executions?run_id=run_abc123xyz&block_id=blk_extract_1' \
  -H 'Authorization: Bearer <your-api-key>'
{
  "data": [],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

run_id
string
required
block_id
string
required
before
string | null
after
string | null
limit
integer
default:20
Required range: 1 <= x <= 100
order
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful Response

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

data
BlockExecution · object[]
required
list_metadata
ListMetadata · object
required

Boundary resource IDs for page navigation.