List pages

Without query, list the outline of pages (titles, no content) and folders, 50 at a time. With query, find the pages whose title or text has every word, each with a snippet.

GET/v1/w/{workspace}/pages

Path parameters

workspacestringrequired

Your workspace’s address name.

Query parameters

cursorstring

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

limitinteger

How many to return, 1 to 200. Defaults to 50.

querystring

Words to find in titles and text.

projectstring

Only this project: general, a product key, or a custom project’s id.

parentIdstring

Only the pages directly inside this page.

Response

pagesobject[]required

nextCursorstring | null

foldersobject[]

Details

Find pages. With query, returns the pages whose title or text has every word, with a snippet. Without it, returns folders and the outline of pages (no content), optionally only one project or the pages inside one page.

Since 2026-12. Errors are listed in Errors.

cURL

curl -G "https://api.olamma.sh/v1/w/your-workspace/pages" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  --data-urlencode 'query=refund policy'

Response 200

{
  "pages": [
    {
      "id": "<string>",
      "title": "<string>",
      "projectId": "<string>",
      "parentId": "<string>",
      "folderId": "<string>",
      "updatedAt": "2026-12-01T09:30:00Z",
      "snippet": "<string>"
    }
  ],
  "nextCursor": "<string>",
  "folders": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ]
}