Grist Octri Preview
POST/docs/{docId}/tables/{tableId}/columns

Add columns to a table

Adds columns to a specified table using the column definitions in the columns array. Provide each column’s configuration in its fields object; the response returns the identifiers of the created columns.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 1 body field
docIdstringrequired
The document identifier in UUID format.
tableIdstringrequired
The normalized table name or the numeric row ID in `_grist_Tables`.

Column definitions to add to the table. The columns array is required.

columnsarray<object>required
The columns to add. Each item can include an identifier in `id` and a `fields` object with the column configuration.

1 status code
200Returns the identifiers of the columns that were created.
columnsarray<object>required

Error handling

The docId path parameter must identify a document, and the tableId path parameter must identify a table by its normalized name or numeric row ID. The columns array is required; each item can include a column identifier in id and configuration in fields.