Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
TrademarkTrademark
Ctrl k
Search...
Sign up
Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
TrademarkTrademark
AveiroBlogContact
© Aveiro. All rights reserved.
Built with Aveiro
Pages

Reorder Pages

POST /api/v1/sites/{siteId}/reorder — reorder, move, or sort pages and folders.
Updated 7d ago
List Pages
Update a Page
In short
POST /api/v1/sites/{siteId}/reorder changes page order inside a folder, moves a page into another folder, or sets a folder's sort mode. Requires content:write. Use `/` for the site root.

Request

POST /api/v1/sites/{siteId}/reorder
Authorization: Bearer av_live_…
Content-Type: application/json
Required scope: content:write The body is discriminated by operation:

operation: reorder

Set the exact order of pages inside one folder. order must list every page in that folder — positions are set to the list index. 
{
  "operation": "reorder",
  "folder": "/blog",
  "order": ["/blog/intro.mdx", "/blog/setup.mdx", "/blog/faq.mdx"]
}
Use "folder": "/" for pages at the site root.

operation: move

Move a page into a folder. When position (0-based) is present, the destination folder is renumbered so the page lands at that slot; otherwise the page is appended. 
{
  "operation": "move",
  "page": "/draft.mdx",
  "folder": "/blog",
  "position": 0
}

operation: sort

Set a folder's sort mode — the same setting the Pages panel uses. Root ("/") sets the site-wide default. 
{
  "operation": "sort",
  "folder": "/blog",
  "mode": "recent"
}
mode must be one of: manual, name-asc, name-desc, recent, published.

Examples (curl)

Reorder pages in a collection: 
curl -s -X POST 'https://help.aveiro.app/api/v1/sites/SITE_ID/reorder' \
  -H 'Authorization: Bearer av_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "operation": "reorder",
    "folder": "/guides",
    "order": ["/guides/index.mdx", "/guides/quickstart.mdx", "/guides/api.mdx"]
  }'
Move a page to the top of the blog:

Responses

200 OK — operation succeeded:
Status
Code
When
400VALIDATION_ERRORMissing fields, incomplete order list, or invalid mode
403FORBIDDENMissing content:write or no access to the site
404PAGE_NOT_FOUNDpage path does not exist
404FOLDER_NOT_FOUNDfolder path does not exist

MCP tool

The Aveiro MCP server exposes aveiro_reorder_pages with the same operation, folder, order, page, position, and mode fields. Default tokens with content:write can call it from Cursor or Claude.
Typical agent flow: aveiro_list_pages → build the desired order → aveiro_reorder_pages with operation: "reorder".

Related

  • List pages
  • Create a page
  • Update a page
  • Platform help: Creating and organizing pages
curl -s -X POST 'https://help.aveiro.app/api/v1/sites/SITE_ID/reorder' \
  -H 'Authorization: Bearer av_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "operation": "move",
    "page": "/announcement.mdx",
    "folder": "/blog",
    "position": 0
  }'
{ "ok": true, "operation": "reorder", "folder": "/blog", "count": 3 }
{ "ok": true, "operation": "move", "path": "/blog/announcement.mdx", "position": 0 }
{ "ok": true, "operation": "sort", "folder": "/blog", "mode": "recent" }