Delete a Page

Request

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

Required scope: content:delete Use the page id from List pages or from a create/update response.

Example (curl)

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

Example (fetch)

const res = await fetch(
  `https://help.aveiro.app/api/v1/sites/${siteId}/pages/${contentId}`,
  {
    method: "DELETE",
    headers: { Authorization: `Bearer ${process.env.AVEIRO_API_TOKEN}` },
  },
);
const body = await res.json();

Response

200 OK Deletion is a soft delete — the page is removed from list/get endpoints and the editor file tree. It does not unpublish live content that was already published; use the editor to unpublish if needed.

Homepage protection

The site homepage (/index.mdx) cannot be deleted. Attempts return: Update the homepage with PATCH instead.

Errors

Bulk cleanup pattern

To remove every page except the homepage (for example when re-seeding a docs site):

• GET /api/v1/sites/{siteId}/pages
• For each page where path !== "/index.mdx", call DELETE …/pages/{id}
• POST new pages at the desired paths

Related

• Create a page
• List pages
• List sites

{
  "deleted": true,
  "id": "343550cc-4b41-4beb-8082-f302766003cf",
  "path": "/old-page.mdx"
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "The homepage cannot be deleted"
  }
}