Restore records

Bring records back from Trash within 30 days, links included.

POST/v1/w/{workspace}/tables/{tableId}/records/restore

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 were in.

Headers

Idempotency-Keystring

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

Body

idsstring[]required

Record ids, at most 500.

Response

recordsobject[]required

Details

Restore up to 500 rows within 30 days, including their links.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/tables/{tableId}/records/restore" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "ids": [
      "tr_…"
    ]
  }'

Response 200

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