Skip to main content
POST
Bulk delete table rows

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

Body

application/json

Request body for the bulk row delete — two scopes, one body.

Send record_ids to delete a checkbox selection. Send all: true to delete every row the current listing matches — optionally narrowed by where/row_status, exactly the predicate vocabulary of the rows query, so "delete everything matching my filters" and "show me everything matching my filters" can never disagree about what matches. The explicit flag exists so an accidentally empty body deletes nothing.

all
boolean
default:false

Delete every matching row rather than a named set. Required (and only honoured) when record_ids is absent.

record_ids
string<uuid>[] | null

Record IDs of the rows to delete.

Required array length: 1 - 1000 elements
row_status
enum<string> | null

Narrow an all delete to errored or fully computed rows.

Available options:
errored,
fully_computed
where
TableRowsWhereSchema · object | null

Narrow an all delete to rows matching this predicate tree.

Response

Successful Response

Result of a bulk row delete; missing record IDs are simply absent.

A predicate (all: true) delete reports only the count — echoing ten thousand UUIDs would say nothing the count does not.

count
integer
required
deleted_record_ids
string<uuid>[]