Update Page

Partially update an existing page.


PATCH /api/pages/:id

Authentication

Required. API key or browser session. You can only update your own pages.

Path parameters

Parameter	Type	Description
`id`	UUID	The page ID

Request body

All fields are optional. Only include fields you want to change.


{
  "title": "Updated Title",
  "description": "New description",
  "slug": "new-slug",
  "components": [
    {
      "type": "hero",
      "props": {
        "headline": "Updated"
      }
    }
  ],
  "theme": {
    "preset": "cyberpunk-neon"
  },
  "customCss": "h1 { font-size: 3rem; }",
  "meta": { "ogImage": "https://example.com/new-og.png" },
  "is_published": true,
  "show_in_widget": false
}

Field	Type	Description
`title`	string	Max 200 chars
`description`	string	Max 2000 chars
`slug`	string	2-60 chars, lowercase alphanumeric + hyphens
`components`	array	Max 50 component objects
`theme`	object	Preset and/or overrides
`customCss`	string	Max 10240 chars
`meta`	object	Metadata fields
`is_published`	boolean	Whether page is publicly visible
`show_in_widget`	boolean	Whether page appears in iOS widget

Response

Status: 200 OK


{
  "page": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "new-slug",
    "title": "Updated Title",
    "...": "..."
  }
}

Errors

Status	Error	When
400	Validation error	Invalid fields, `details` included
401	Not authenticated	Missing or invalid auth
404	Page not found	ID doesn’t exist or not owned by you