Create a Page

POST /api/v1/sites/{siteId}/pages
Authorization: Bearer av_live_…
Content-Type: application/json
Idempotency-Key: create-docs-overview-v1

{
  "path": "/guides/overview.mdx",
  "content": "# Overview\n\nWelcome to the guides.",
  "metadata": {
    "title": "Overview",
    "summary": "Getting started with our API"
  }
}

curl -s -X POST 'https://help.aveiro.app/api/v1/sites/SITE_ID/pages' \
  -H 'Authorization: Bearer av_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: create-overview-2026-07-08' \
  -d '{
    "path": "/guides/overview.mdx",
    "content": "# Overview\n\nDraft content here.",
    "metadata": { "title": "Overview" }
  }'

{
  "page": {
    "id": "new-content-uuid",
    "path": "/guides/overview.mdx",
    "title": "Overview",
    "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=new-content-uuid",
    "content": "# Overview\n\nDraft content here.",
    "metadata": { "title": "Overview" },
    "revision": "version-uuid"
  }
}

{
  "error": {
    "code": "FOLDER_NOT_FOUND",
    "message": "Parent folder /docs/api does not exist. Create the folder in the editor first."
  }
}