Record history

See who changed a record and what each cell held before, newest first, 50 entries at a time. History is kept for 180 days.

GET/v1/w/{workspace}/records/{recordId}/history

Path parameters

workspacestringrequired

Your workspace’s address name.

recordIdstringrequired

The record, from List records.

Query parameters

cursorstring

The nextCursor from the previous page; leave out for the first page.

limitinteger

Entries per page, 1 to 50. Defaults to 50.

Response

entriesobject[]required

nextCursorstring | nullrequired

untrustedstring[]

Details

Read who changed a row and its previous values, newest first. At most 50 entries per page; follow nextCursor explicitly. History is kept for 180 days; truncated values cannot be restored.

Since 2026-12. Errors are listed in Errors.

cURL

curl "https://api.olamma.sh/v1/w/your-workspace/records/{recordId}/history" \
  -H "Authorization: Bearer $OLAMMA_KEY"

Response 200

{
  "entries": [
    {
      "id": "<string>",
      "actor": "<string>",
      "kind": "<string>",
      "at": "<string>",
      "changes": [
        {
          "fieldId": "<string>",
          "from": {},
          "to": {},
          "truncated": true
        }
      ]
    }
  ],
  "nextCursor": "<string>",
  "untrusted": [
    "<string>"
  ]
}