Grist Octri Preview
PATCH/docs/{docId}/tables/{tableId}/records

Modify records in a table

Updates fields on existing records in a table, identified by each record’s numeric id. Supply the column values to change in each record’s fields object; use noparse to prevent strings from being parsed according to column types.

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

3 parameters · 1 body field
docIdstringrequired
The document identifier in UUID format.
tableIdstringrequired
The normalized table name or the numeric row ID in `_grist_Tables`.
noparsebooleanoptional
Set to true to prevent strings from being parsed according to the column type.

Records to update. Each record must include its numeric id and a fields object mapping column names to cell values.

recordsarray<object>required
The records to change. Each item requires an `id` and `fields`; the read-only `errors` property represents formula errors when present.

1 status code
200Returns confirmation that the record updates were applied.

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 records array is required, and each record must include a numeric id and a fields object.