List Pages

Request

GET /api/v1/sites/{siteId}/pages
Authorization: Bearer av_live_…

Required scope: content:read Replace {siteId} with a site id from List sites.

Example

curl -s 'https://help.aveiro.app/api/v1/sites/SITE_ID/pages' \
  -H 'Authorization: Bearer av_live_…'

Response

200 OK

Get one page

By content ID:

GET /api/v1/sites/{siteId}/pages/{contentId}

By path:

GET /api/v1/sites/{siteId}/pages/by-path?path=/guides/foo.mdx

Both return full content, metadata, and revision (latest content version id).

Reorder, move, or sort

After listing pages, use Reorder pages to change tree order without editing MDX:

POST /api/v1/sites/{siteId}/reorder

Operations: reorder (explicit sibling order), move (page into a folder), sort (folder sort mode). MCP clients can call aveiro_reorder_pages with the same fields.

Review unpublished changes

GET /api/v1/sites/{siteId}/changes

Returns only pages where dirty is true — useful after a CI sync to see what still needs human review before publish.

Related

• Create a page
• Update a page
• Delete a page

{
  "pages": [
    {
      "id": "343550cc-4b41-4beb-8082-f302766003cf",
      "path": "/sites/list-sites.mdx",
      "title": "List Sites",
      "dirty": true,
      "never_published": true,
      "updated_at": "2026-07-08T09:00:00.000000+00:00",
      "editor_url": "https://help.aveiro.app/en/ORG_ID/SITE_ID/edit?file=343550cc-…"
    }
  ]
}