Add records

Add up to 100 records in one call. Cells are keyed by field id; leave a field out to leave it empty. Values follow each field’s type: see Working with Tables.

POST/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 to add to.

Headers

Idempotency-Keystring

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

Body

recordsobject[]required

Up to 100 records, each { "cells": { fieldId: value } }.

Response

recordsobject[]required

untrustedstring[]

Details

Add up to 100 rows. Currency values are integer minor units. Rating is an integer 1..max, Percent is a finite number (50 means 50%), Duration is integer seconds 0..36000000. Null clears a value. Use field and choice ids from get_table. Automatic, Formula, Lookup and Rollup fields are read-only. Link values are live target record id arrays or {add,remove}; at most 1,000 changes per write and 5,000 links per cell.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/tables/{tableId}/records" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "records": [
      {
        "cells": {
          "tf_customer": "Ada Okafor",
          "tf_total": 125000,
          "tf_status": "paid",
          "tf_due": "2026-12-15"
        }
      },
      {
        "cells": {
          "tf_customer": "Lin Chen",
          "tf_total": 48000,
          "tf_status": "pending"
        }
      }
    ]
  }'

Response 201

{
  "records": [
    {
      "id": "<string>",
      "cells": {},
      "source": "<string>",
      "createdAt": "2026-12-01T09:30:00Z",
      "updatedAt": "2026-12-01T09:30:00Z"
    }
  ],
  "untrusted": [
    "<string>"
  ]
}