POST/v1/records/{id}

Update a record

Updates a record in a table. Supply tableId and any cells to update, with each cell identifying a field and its value. Use agentUpdate to indicate whether the update is an agent update.

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

1 parameter · 3 body fields
idstringrequired
The identifier of the record to update.

Record update data, including the table identifier and any cell values to change.

agentUpdatebooleanoptional
Indicates whether the record update is an agent update.
cellsarray<object>optional
The cells to update, each containing a field identifier and a string or null value.
tableIdstringrequired
The identifier of the table containing the record.

1 status code
200Returns the updated record, including its identifiers, timestamps, table and project identifiers, and cell values.
cellsobjectrequired
createdstringrequired
idstringrequired
projectIdstringrequired
tableIdstringrequired
updatedstringrequired

Error handling

The id path parameter must identify the record to update. The body must include tableId; each supplied cell must include fieldId and value.