Move to Trash

Move a page, and the pages inside it, to Trash. Bring it back with Restore page.

POST/v1/w/{workspace}/pages/{id}/trash

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

Path parameters

workspacestringrequired

Your workspace’s address name.

idstringrequired

The page’s id, like pg_…, from List pages.

Headers

Idempotency-Keystring

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

Response

pageobjectrequired

Details

Move a page and its children to Trash; published copies become unavailable.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/pages/{id}/trash" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>"

Response 200

{
  "page": {
    "id": "<string>",
    "deletedAt": "2026-12-01T09:30:00Z"
  }
}