Skip to main content
POST
Cancel a table run

Authorizations

Authorization
string
header
required

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

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_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. Free, never retried, and excluded from errored views. 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.

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'.