Publish page

Propose publishing a page on the web. It always waits for a person to approve it in Olamma, and needs public pages to be on for the workspace.

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

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.

Body

indexingboolean

true to let search engines list it.

includeLiveDataobject

Response

statusobjectrequired

approvalIdstringrequired

Details

Propose publishing a saved page for readers. A person must approve.

Since 2026-12. Errors are listed in Errors.

cURL

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

Response 202

{
  "status": "awaiting_approval",
  "approvalId": "<string>"
}