Update a Page

Request

PATCH /api/v1/sites/{siteId}/pages/{contentId}
Authorization: Bearer av_live_…
Content-Type: application/json
If-Match: revision-uuid-from-last-read

{
  "content": "# Updated title\n\nNew body.",
  "metadata": {
    "title": "Updated title",
    "summary": "New summary"
  }
}

Required scope: content:write At least one of content or metadata must be provided.

Optimistic concurrency

When you last read a page, note the revision field. Send it as:

• Header: If-Match: {revision}, or
• Body field: "base_revision": "{revision}"

If someone else edited the page since your read, the API returns 409 REVISION_CONFLICT with the current revision in error.details. Re-fetch, merge, and retry — or omit If-Match to force an overwrite.

Example

curl -s -X PATCH 'https://help.aveiro.app/api/v1/sites/SITE_ID/pages/CONTENT_ID' \
  -H 'Authorization: Bearer av_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"content": "# Hello\n\nUpdated copy."}'

Response

200 OK — same shape as Create a page ({ page: { … } }).

Limitations

• Path moves are not supported — sending path returns 400 VALIDATION_ERROR
• Updates are draft-only — publish in the editor
• MDX must pass server-side validation (422 INVALID_MDX on failure)

Related

• Create a page
• Delete a page
• List pages