Skip to main content
POST
Run several columns over chosen rows

Authorizations

X-API-Key
string
header
required

Path Parameters

table_id
string<uuid>
required

Body

application/json

Cell-scoped run over several columns at once, as ONE dependency-ordered plan.

column_ids
string<uuid>[]
required

The computed columns to run, in any order. A column another one here feeds is planned once, AFTER its input, so no column reads a value a sibling is still computing. Sending one request per column instead is what makes them race.

Required array length: 1 - 100 elements
record_ids
string<uuid>[]
required

The target rows, shared by every column named — a swept selection is a rectangle. Duplicates are dropped and the order is kept.

Required array length: 1 - 1000 elements

Response

Successful Response

Result of requesting an on-demand column run.

run is None when the workflow start is still queued (the run row is minted post-commit) — the frontend's 2-second active-runs poll picks it up.

run
TableRunReadSchema · object | null
required

A table recompute run with its static denominator and monotone counters.