v2

latestOpenAPI 3.1.02026-07-26143251806.6 KB

smart-tables

Add Rows

Append one or more rows to a sheet. Text column values can be set immediately; non-text column cells are created with stale status and must be triggered via a recalculation. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

post/api/public/v2/tables/{table_id}/sheets/{sheet_id}/rows

Path parameters

table_idstring uuid required

sheet_idstring uuid required

Request body

countinteger

Number of rows to append (1–100).

valuesobject[] nullable

Per-row initial values for text columns. Each element is a map of column_id → value.

Response

Rows added

successboolean

rows_createdinteger

start_row_indexinteger

row_indicesinteger[]

cell_countinteger

row_countinteger

versioninteger

Current sheet version_count for this response. It matches the sheet's version_count after any committed changes.