Skip to main content
POST
Cancel a table run

Authorizations

X-API-Key
string
header
required

Path Parameters

table_id
string<uuid>
required
run_id
string<uuid>
required

Response

Successful Response

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

cells_awaiting
integer
required

Cells the run held because an input they read has not been computed yet. Not a final state: a later run fills them. Counted within cells_done.

cells_done
integer
required

Cells processed so far; clamped to cells_total so the banner can never overshoot.

cells_failed
integer
required

Cells whose formula evaluation failed.

cells_no_data
integer
required

Cells that ran clean but found nothing. Never retried, and excluded from errored views. Free for a lookup; an AI column's cell is charged what it used. Counted within cells_done.

cells_skipped
integer
required

Cells the run deliberately skipped: a missing required input or a false run condition. Counted within cells_done.

cells_total
integer
required

Exact static denominator, fixed when the run plan is minted.

completed_at
string<date-time> | null
required
created_at
string<date-time>
required
error
string | null
required

Failure description when the run status is failed.

id
string<uuid>
required
row_scope
TableRunRowScopeReadSchema · object
required

The rows this run resolved to at mint. Present on every read so a resync cannot lose it and silently fall back to painting the whole column busy.

started_at
string<date-time> | null
required
status
enum<string>
required

The run's lifecycle status.

Available options:
pending,
running,
cancelling,
cancelled,
paused_for_credits,
completed,
completed_with_errors,
failed
table_id
string<uuid>
required
trigger
enum<string>
required

What kind of mutation requested the run.

Available options:
cell_edited,
row_added,
row_manual,
column_added,
column_edited,
column_manual
column_id
string<uuid> | null

The column a column-lineage run recomputes, parsed from its workflow identity; null for whole-table runs. Narrows the grid's busy paint to one column; row_scope is what narrows it to the rows within that column.

column_ids
string<uuid>[] | null

Every column this run's plan covers, in dependency (layer) order, not the order they were requested in. Null on runs minted before the plan was published, where column_id is all there is. This is what narrows the grid's busy paint when one run covers several columns, which column_id cannot express.

credits_charged
number
default:0

Credits charged so far. Grows while the run works, as its finished cells are settled every few seconds; final once the run ends.

export_retry_attempt
integer
default:0

How many automatic export retries preceded this run. 0 is a run a person or a schedule asked for; higher values mark the follow-ups queued for rows whose push failed for a retryable reason, so a run history can tell 'we tried again' from 'you ran it again'.