OlammaAPI
Menu

Update records

Change cells on one or more records, all or nothing. Send each cell’s new value with the value you last read: if someone changed it meanwhile, nothing is written and you get a conflict with the current values to decide from.

PATCH/v1/w/{workspace}/tables/{tableId}/records

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

tableIdstringrequired

The table the records are in.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

updatesobject[]required

Up to 500 cells in all: [{ "id": record id, "cells": { fieldId: { "value": new, "previous": last read } } }].

Response

recordsobject[]required
untrustedstring[]

Details

Update cells atomically (up to 500 cells). Rating, Percent and Duration use JSON numbers (duration in seconds); null clears. Send {value,previous} per field; cell_conflict includes current values. Automatic, Formula, Lookup and Rollup fields are read-only. Links accept id arrays or {add,remove}, with 1,000 changes per write and 5,000 per cell. Never blindly retry conflicts.

Since 2026-12. Errors are listed in Errors.