Delete records

Move records to Trash. They stay restorable, with their links, for 30 days.

DELETE/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

idsstring[]required

Record ids, at most 500.

Response

deletedstring[]required

Details

Move up to 500 rows to Trash. Links return when the rows are restored.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X DELETE "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 '{
    "ids": [
      "tr_…",
      "tr_…"
    ]
  }'

Response 200

{
  "deleted": [
    "<string>"
  ]
}