v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB

DataTables

Updates a row (partial update).

put/datatables/{tableId}/rows/{rowId}

Path parameters

tableIdstring required

The data table ID.

rowIdstring required

The row ID.

Headers

If-Matchstring

Optional optimistic-concurrency token. Supply the ETag value returned by a prior read as the If-Match header; the update is rejected with 409 Conflict if the row changed in the meantime. Omit to update unconditionally.

Request body

dataobject required

Free-form JSON object keyed by column key; each value is a raw JSON scalar, object, or media object.

Response

idstring nullable

sortOrderinteger

dataobject nullable

Stored row data as a JSON object keyed by column key. Values follow each column's ColumnType rules: STRING/RICHTEXT/HIDDEN/SELECT/URL/DATE/TIME are JSON strings, NUMBER is a JSON number, BOOLEAN is JSON true/false, and MEDIA is always a normalized object { url, thumbnailUrl, name, mimeType, mediaId? } (id and id-object input forms are expanded server-side at write time).

updatedAtstring date-time

eTagstring nullable

Optimistic concurrency token. To ensure the row hasn't changed since you read it, send this value back as the If-Match request header on the REST updateDataTableRow (HTTP PUT) call, or as the eTag input field on the GraphQL updateDataTableRow mutation. A stale token results in 409 Conflict (REST) or a mutation error (GraphQL). Note: the REST endpoint does not read an eTag body property — it uses the If-Match header.