A Page is returned as a JSON object with object: "page". GET /pages/{id} extends the shape with a blocks[] array — the full ordered block tree, documented on Blocks .
Example { "object" : "page" , "id" : "c4d5e6f7-8a9b-4c0d-1e2f-3a4b5c6d7e8f" , "slug" : "fall-tasting" , "public_slug" : "fall-2024-tasting" , "status" : "active" , "title" : "Fall 2024 Tasting Notes" , "description" : "Six wines, six stories." , "background" : { "type" : "gradient" , "value" : "linear-gradient(to bottom right, #f9f4ec, #e6d6b8)" , "animated" : false }, "island" : { "color" : "#ffffff" , "opacity" : 1 , "shadow" : "md" , "roundness" : "3xl" }, "favicon_url" : "https://files.awardee.dev/orgs/.../favicon.ico" , "meta_title" : "Fall 2024 Tasting Notes — Reserve Wines" , "meta_description" : "Six wines, six stories. The full set of fall tasting notes." , "og_image_url" : "https://files.awardee.dev/orgs/.../og.jpg" , "view_count" : 8421 , "created_at" : "2024-08-30T15:01:09Z" , "updated_at" : "2026-05-12T11:42:00Z" , "blocks" : [ { "id" : "11111111-1111-4111-8111-111111111111" , "type" : "heading" , "config" : { "text" : "Fall 2024" , "level" : 1 , "alignment" : "center" }, "sort_order" : 0 , "spacing_top" : 0 , "spacing_bottom" : 16 }, { "id" : "22222222-2222-4222-8222-222222222222" , "type" : "text" , "config" : { "content" : "Six wines, six stories." , "alignment" : "center" }, "sort_order" : 1 , "spacing_top" : 0 , "spacing_bottom" : 24 }, { "id" : "33333333-3333-4333-8333-333333333333" , "type" : "image" , "config" : { "url" : "https://files.awardee.dev/orgs/.../tasting-hero.jpg" , "fileName" : "tasting-hero.jpg" }, "sort_order" : 2 , "spacing_top" : 0 , "spacing_bottom" : 24 }, { "id" : "44444444-4444-4444-8444-444444444444" , "type" : "button" , "config" : { "label" : "Reserve a tasting" , "iconPosition" : "end-gap" , "destination" : { "type" : "url" , "value" : { "url" : "https://example.com/book" } } }, "sort_order" : 3 , "spacing_top" : 0 , "spacing_bottom" : 0 } ] }
Identifiers Stable UUID. Use this in /pages/{id} and as the target of destination.page on QR codes and products.
Operator-facing slug. Editable in the dashboard. Used for internal dashboard navigation and as the default surface name when no public_slug is set.
The slug exposed in public page URLs. Distinct from slug because the operator may want a clean public address that’s independent of internal renames. Stable within the page’s life; changes only on explicit operator edit.
Status One of draft, active, inactive, archived. See the overview for behaviour per status. Content Page title. Rendered in the editor’s tab and used as the default <title> when meta_title is unset.
Free-form description. Operator-facing — distinct from meta_description below.
Background The page background. Discriminated on type: color, gradient, image, or video. { "type" : "color" , "value" : "#f9f4ec" }
value is any valid CSS colour string.{ "type" : "gradient" , "value" : "linear-gradient(to bottom right, #f9f4ec, #e6d6b8)" , "animated" : false , "animatedStops" : [ "linear-gradient(...)" , "linear-gradient(...)" ] }
value is a raw CSS gradient string. When animated is true, the renderer cycles through animatedStops (or a built-in cycle if unset).{ "type" : "image" , "url" : "https://files.awardee.dev/..." , "overlayColor" : "#000000" , "overlayOpacity" : 0.25 }
Overlay is optional. Use it to soften busy hero images. { "type" : "video" , "url" : "https://files.awardee.dev/..." , "poster" : "https://files.awardee.dev/..." }
poster is shown while the video buffers.Island The “island” is the content card that sits on the background.
Island background colour. Defaults to #ffffff.
0 (fully transparent) to 1 (fully opaque). Defaults to 1.
One of none, sm, md, lg, xl. Defaults to md.
One of none, sm, md, lg, xl, 2xl, 3xl. Defaults to 3xl.
URL for the browser tab favicon. null falls back to the org default.
Override for the <title> tag. Falls back to title when unset.
Override for the <meta name="description"> tag. Falls back to description when unset.
Override for the Open Graph image. Used by social previews. Falls back to a brand default when unset.
Stats Lifetime view count. Increments on every public render. Read-only.
Timestamps created_at
string (datetime)
required
When the page was created.
updated_at
string (datetime)
required
Last mutation timestamp.
Blocks GET /pages/{id} extends the response with a blocks[] array, ordered by sort_order. Each block has the envelope:{ "id" : "block-uuid" , "type" : "heading" , "config" : { /* shape depends on type */ }, "sort_order" : 0 , "spacing_top" : 0 , "spacing_bottom" : 0 }
See Blocks for the per-type config shape.
Ordered list of block objects. Empty for blank pages.
