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

Add tables to a document

Adds tables to a document, with each table specifying its columns. Include the column definitions in each table’s columns array; the response returns the identifiers of the created tables.

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

1 parameter · 1 body field
docIdstringrequired
The document identifier in UUID format.

Tables to add. Each table must include a columns array containing its column definitions.

tablesarray<object>required
The tables to add. Each item requires a `columns` array; each column can include an identifier and a `fields` object with its configuration.

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

Error handling

The docId path parameter must identify a document. The tables array is required, and each table must include a columns array; column definitions can include an id and a fields object.