Build and host a small business website: write its pages, move an existing site in, add a domain.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Make a new, empty site, live at once at https://<slug>.miow.me. Returns its token (pass it to every other tool as `token`) and a claim link. Give the claim link to your human: opening it on their phone saves a passkey that makes them the owner. An unclaimed site is deleted after seven days. Then fill the site with write_site.
The business's name
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 25, 2026.
Make a new, empty site, live at once at https://<slug>.miow.me. Returns its token (pass it to every other tool as `token`) and a claim link. Give the claim link to your human: opening it on their phone saves a passkey that makes them the owner. An unclaimed site is deleted after seven days. Then fill the site with write_site.
| Argument | Type | Description |
|---|---|---|
| name* | string | The business's name |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The business's name"
}
}
}Delete a wiki page and its whole history. This cannot be undone, and restore_wiki_page cannot bring it back: read it first with read_wiki_page if it may be wanted. A category's hub article is its category's path.
| Argument | Type | Description |
|---|---|---|
| path* | string | "" for the home page, a category's path for its hub, else <category path>/<slug> |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "\"\" for the home page, a category's path for its hub, else <category path>/<slug>"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Whether a pending domain from set_domain is live yet, and the DNS records still missing if not. DNS can take an hour to be seen; call again later rather than in a loop.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}A site's name, theme, header, address and every page by path and title, plus its status: a running or failed job (from import_site) and its domain. Call before changing a site you did not just create; write_site replaces the header whole, so change it from this one. With `site` and no token, any live site's name, address and pages as it lists them, a wiki's being its articles outside hidden categories, without its status.
| Argument | Type | Description |
|---|---|---|
| site | string | Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"properties": {
"site": {
"type": "string",
"description": "Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}The site's visitors, agents, page views, bounce rate and visit length over the last `days` days, the same figures for the same number of days before, visitors and agents by day, the agents by name, its most visited pages, entry pages, sources (a referring host or a link's utm_source), countries (ISO codes) and devices, and what visitors searched the site for and found nothing. A visitor is one browser on one day, counted without cookies. An agent (an AI crawler, an MCP client, or anything reading the site's markdown, llms.txt or .well-known files) is counted the same way and never among the visitors.
| Argument | Type | Description |
|---|---|---|
| days | number | 1 to 365; 30 if omitted |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "1 to 365; 30 if omitted"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}The last 30 changes to the site, newest first: what each did, who made it and when. Pass a change id to undo to put the site back as it was before that change.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Replace the site's pages with an existing website's (Squarespace, Wix, or anything with a sitemap), word for word, at the same paths, with its images copied across. Runs in the background for a minute or two: poll get_site until `job` is null, or read its error.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| source* | string | The current website, e.g. https://example.com |
{
"type": "object",
"required": [
"source"
],
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"source": {
"type": "string",
"description": "The current website, e.g. https://example.com"
}
}
}A link that makes whoever opens it the owner of a site nobody owns yet, after saving a passkey. Works once, for two weeks. Give it to the person who should own the site, never post it. Once the site has an owner, they invite others from its settings.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}One page whole, in the shape write_site takes, so you can change it and send it back. Read every page you mean to change first: write_site replaces a page whole. With `site` and no token, the page as its address shows it: on a wiki, the article there; a sold product without its price.
| Argument | Type | Description |
|---|---|---|
| path* | string | "" for the home page |
| site | string | Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "\"\" for the home page"
},
"site": {
"type": "string",
"description": "Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}One wiki page whole: its title, blocks, metadata, version and how many revisions it has. Pass its version as base_version when you save it back.
| Argument | Type | Description |
|---|---|---|
| path* | string | "" for the home page, a category's path for its hub, else <category path>/<slug> |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "\"\" for the home page, a category's path for its hub, else <category path>/<slug>"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Put a wiki page back as one of its revisions had it. The restore is a revision of its own, so it can be undone the same way.
| Argument | Type | Description |
|---|---|---|
| path* | string | "" for the home page, a category's path for its hub, else <category path>/<slug> |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| revision_id* | string | From wiki_history |
{
"type": "object",
"required": [
"path",
"revision_id"
],
"properties": {
"path": {
"type": "string",
"description": "\"\" for the home page, a category's path for its hub, else <category path>/<slug>"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"revision_id": {
"type": "string",
"description": "From wiki_history"
}
}
}Create a wiki page, or change one, as one revision of its history. Send the blocks whole, with base_version from read_wiki_page: a save over a page someone changed since is refused, and you read it again. A change to blocks or title moves its version (major for added, moved or removed blocks, minor for changed words); a metadata-only change moves nothing. Pages - path "" is the home page and must exist. Other paths are lowercase slugs, slash-separated, no leading slash. - navOrder places a page in the header nav (0 first); null keeps it out. The home page is reached by the site name, so give it null. - path "search" is the site's search results page, which every site has; no page takes it. - path "_footer" is not a page to visit but the footer shown under every page: addresses, hours, contact details. Content, locations and columns blocks, no hero and no h1, navOrder null. A site without one has no footer. - description is the page's search snippet: one sentence, under 160 characters. - Omit the id of a block you add, and keep every id a page was read with, so a wiki page's history matches its blocks one for one. Blocks - A page is a list of blocks, stacked vertically. Every page has exactly one h1: an opening hero's heading, a product's or a products list's with a menu, or else an h1 at the top of its first content block. - "hero" is a heading, a sentence or two of plain text, and optionally one button. It opens a page, its heading the h1: use one on the home page and on pages that sell something. With "call": true it is a call to action further down instead, its heading an h2: at most one on a page, usually last, asking for one action, with a button. Its heading and text are plain text that may wrap words in <strong> or <em>, as the source sets them bold or italic, and its text may link words with <a href>, as the source links them; words in <strong> in its heading are also drawn in the accent colour. Its optional image is a picture filling it behind the words, by https URL, under the same rule as a pictures block. Where its words are a subheading rather than a sentence (a line or two, often set as headings at the source), give "subheading": true. With no picture, "backdrop": "mesh", "grain", "flow" or "marble" sets a slowly moving field of the site's own colours behind the words, smooth, grainy, folding like poured paint, or hard-edged as marbled paper, and "backdropSpeed" and "backdropIntensity", each 0 to 1, set how fast it moves (0.25 unset) and how strongly it folds (0.5 unset): at most one on a site, on the home page's opening, for a brief that wants a modern or striking look, and never on a site moved across from elsewhere. Over a picture or backdrop its words sit on boxes of the page's background; "box": "panel" or "accent" sets them on that colour instead, and "none" sets light words on the picture itself. - "content" holds HTML, plain and semantic: h1–h4, p, ul, ol, li, a, strong, em, blockquote, table, hr. No class, style or script: they are stripped. No img either: a picture goes in a pictures block. After a hero, headings start at h2. - "columns" sets 2–4 columns side by side, each {"blocks": [...]} of the blocks a column may hold (content, pictures, figures, code, link groups, references, notices, lists, events, locations): for features, services or contact details. They stack on a phone. To place them freely instead, as a page builder's grid does, give every column an "area": {"col", "span", "row", "rows"} on twelve columns, rows counted from 1 (up to 12 columns then); cells may sit lower than their neighbours or overlap. With "beside": true and one column, it is a facts panel beside the text instead: on a page about one thing (a product, a place, an organisation), placed before the page's content, its usual content a picture and a two-column table of facts. - "pictures" shows pictures by https URL, {"items": [{"src", "alt": what it shows, "caption"?}]}: one is a figure, several a row the visitor scrolls sideways. A video file is an item with "video": true, its src an MP4, and "poster"?: the picture it shows before it plays. Use only picture and video URLs the brief gives you; never invent one. For any gallery or slideshow on a site being moved across, one pictures block holding each picture once, in order, without the slideshow's counters ("Image 1 of 12") or its thumbnails. A YouTube link is an iframe in a content block. - "product" makes its page one thing for sale: {"images": [https URLs, the first on every listing], "price"?: as it reads ("£2,500"), "sold"?: true, "tags": [the lists it appears in], "text": HTML of what it is (materials, size, year, words about it)}. It draws the page's title as the h1, so the page has no hero; it goes first. One product per page. Write a price as an amount, "£2,500", "$40" or "€12.50", and the product can be bought online once the site takes payment; "from £40" or "POA" keeps it to the Enquire button. Where it is sold elsewhere, as a book is by its publisher, give it "action": {"label": "Buy from Salmon Poetry", "href": the page that sells it}. A service, booked rather than sold (a lesson, a treatment, a consultation), is a product with "service": true, "duration"?: how long it takes as it reads ("1 hour"), and "unit"?: what its price is for as it reads after it ("an hour", "per person"); its button reads Book, and where it is booked elsewhere, "action" goes to that calendar. "sold" on a service means fully booked. - "list" lists pages of the site, read as the page is: {"source": "under", "under"?: a path} the pages directly under it, a section's index page; {"source": "newest", "count"?, "under"?} the most recently changed, a blog's latest posts; {"source": "chosen", "pages": [paths]} those, in order; or {"source": "products", "tag"?} the product and service pages with that tag, or all, newest first. "show": "cards" (the default) draws each page's first picture, title and search snippet, "links" each title with how long ago it changed; products are always cards of their pictures, name and price, cropped square, "shape": "portrait" upright for books and posters, "landscape" wide. A shop with several lists gives each list's products block a "menu" of links to all of them, [{"label": "All", "href": "/shop"}, …], shown down the left; the block then heads the page with its title, so the page needs no other h1. A list is drawn from each page, so never copy a product's pictures, name or price onto another page; list it. - "donate" takes gifts for a charity or a cause: {"amounts": the suggested gifts in one currency, as they read (["£10", "£20"]), "monthly"?: true where donors may give every month as well as once}. The donor may always give an amount of their own. It shows once the site takes payment. Use it only where the brief asks for donations, with the words that ask for them before it. - "stats" sets 1–12 figures in a row, each {"value": as it reads ("1987", "40+"), "label": what it counts}: years open, customers served, awards. Only figures the brief gives. - "testimonial" is one person's words about the business: {"quote": their words exactly, "author": their name, "role"?, "avatarUrl"?: their photo by https URL}. Only quotes the brief gives, never one written for them. - "poem" sets one poem, or a song's words, line for line as written: {"title"?, "text": plain text, a line to a line, a blank line between stanzas, the spaces that indent a line kept, and words set in italic or bold wrapped in <em> or <strong>, "note"?: one line under it, such as where it first appeared}. Verse goes in a poem block, never a content block, whose paragraphs would run its lines together. Copy every word, line break and indent exactly, and only poems you were given. - "events" lists exhibitions, shows, talks or performances, {"upcoming"?: the heading over those to come or on now ("Upcoming exhibitions"; unset, "Upcoming"), "past"?: the heading over those that have ended (unset, "Past"), "items": [{"date": when it starts, as precisely as given, "2026", "2026-11" or "2026-11-12", "end"?: when it ends, written the same way, "text": what it is and where, plain text that may link words with <a href>}]}. Give every event in one block, in any order: the page sets those to come soonest first under one heading and those that have ended latest first under the other, by the day it is read, so an event moves on its own once it ends. Never split a list into upcoming and past by hand, and never write its dates into the text as well. Its headings are h2s, so a page about events opens on an h1 before it. - "locations" sets out where a business is and when it is open, {"heading"?: an h2 over them, "map"?: true to set a map of each address under it, "items": [{"name"?: which one, where it has several ("Covent Garden"), "image"?: a picture of it by https URL, under the same rule as a pictures block, "address"?: plain text, a line to a line, "map"?: the link to it on a map the source gives, "phone"?, "email"?, "hours"?: [{"days": ["mon", …, "sun"], "opens": "08:00", "closes": "18:00"}], "timeZone"?: its IANA zone where it is not in the UK ("America/Los_Angeles"), "note"?: what the hours do not say, plain text ("Closed on bank holidays")}]}. A row of hours for each set of days that keeps the same times, and two rows for a day it closes in the middle of; a day in none reads Closed, and a closing time at or before the opening one is the next morning. The page groups the days ("Mon–Fri 8am–6pm") and says whether each is open now, by its own clock, so never write hours, an address or its phone number into a content block as well. Every shop, studio or office's address and hours go in one, on its contact or visit page and in the footer; a page about several gives every one in one block. Only hours given as regular opening hours: visits by appointment, or a reading on the third Tuesday of the month, are words in a note or a content block. Its names are h2s, or h3s under its heading. - "codeTabs" shows code to copy in tabs, {"tabs": [{"label": "JavaScript", "language"?: "javascript", "code": "…"}]}: for a developer or a product with an API. - "linkGrid" sets groups of links under a heading each, {"intro"?, "groups": [{"heading", "description"?, "links": [{"label", "href"}]}]}: a page of resources, or the places to go next. - "references" lists the sources a page's claims rest on, {"title"?, "items": [{"text": the citation as HTML, "url"?}]}: at the foot of a page that cites them. - "banner" is a notice at the top of a page about the page itself, {"variant": "stub" | "unsourced" | "outdated" | "promotional" | "cleanup" | "coi", "text"?: words in place of the standard notice}: on a wiki, where a page needs work. - "contents" lists links to the page's own sections, its h2s. Use it at the top of a long page with several sections. - "comments" lets visitors comment on the page, each comment shown once an owner approves it. Use it only where the brief asks for comments, usually at the foot of a blog post. - "contact" is a form for a visitor's name, email address and message, which reaches the site's owners privately and never shows on the site. Use it on a contact page, and wherever the brief asks to be written to but gives no address to publish. - "search" is a box that searches the site's pages as a visitor types; Enter opens the site's search page, /search, with every page that matches. Use it on a site of many pages, on the home page or a page of its own. - Any block of the page's own (not one inside columns) may take "band": "panel" or "accent", which sets it on a strip of that colour from edge to edge. Use bands sparingly, to set a section apart; consecutive blocks with the same band read as one section. - A button's href is a page on the site ("/contact"), an https URL, a mailto: or a tel: address. Link between pages with root-relative hrefs, never the full domain. - Write every phone number as a tel: link and every email address as a mailto: link, so a visitor on a phone can tap it. Theme - Each value is a CSS colour, OKLCH preferred, e.g. "oklch(0.72 0.16 40)". Choose what suits the business, and keep text readable on bg (contrast 4.5:1 or better) and muted text still legible. - --font-sans is one of these values, written exactly: Clean: "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif"; Friendly: "ui-rounded, SF Pro Rounded, Nunito, Varela Round, system-ui, sans-serif"; Humanist: "Optima, Candara, Seravek, Gill Sans Nova, Noto Sans, sans-serif"; Classic: "Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif"; Elegant: "Iowan Old Style, Palatino Linotype, Palatino, URW Palladio L, serif"; Typewriter: "ui-monospace, SF Mono, Menlo, Consolas, monospace"; Inter: "var(--font-inter), ui-sans-serif, system-ui, sans-serif"; Geist: "var(--font-geist), ui-sans-serif, system-ui, sans-serif"; DM Sans: "var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif"; Manrope: "var(--font-manrope), ui-sans-serif, system-ui, sans-serif"; Nunito: "var(--font-nunito), ui-rounded, system-ui, sans-serif"; Work Sans: "var(--font-work-sans), ui-sans-serif, system-ui, sans-serif"; Space Grotesk: "var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif"; Bricolage Grotesque: "var(--font-bricolage), ui-sans-serif, system-ui, sans-serif"; Lora: "var(--font-lora), Georgia, serif"; Playfair Display: "var(--font-playfair), Georgia, serif"; Instrument Serif: "var(--font-instrument-serif), Georgia, serif"; Source Serif: "var(--font-source-serif), Georgia, serif"; Crimson Pro: "var(--font-crimson), Georgia, serif"; Bitter: "var(--font-bitter), Rockwell, Georgia, serif"; Young Serif: "var(--font-young-serif), Georgia, serif"; JetBrains Mono: "var(--font-jetbrains), ui-monospace, monospace". The first six use fonts every device has; the rest are web fonts miow serves. Nothing else loads, and a value with quotes is discarded. - roundness, density, scale and depth are numbers from 0 to 1 that shape every page: corners from square to round, spacing from roomy to compact, headings from close to body size to far larger, and shadow from flat to raised. Choose them for the business as you choose its colours; 0.33, 0.5, 0.5 and 0 is a plain, even look. - --hero-entrance makes an opening's words arrive as the page opens: "rise", "focus" or "unveil". Leave it unset unless the business suits motion. - Looks to start from, each its colours in words and the rest of its theme. Where one suits the business, take its theme whole and choose colours that match its words, in the business's own hue: - Gallery: white walls and near-black ink, one quiet accent, a slim display serif over a clean sans, square corners and wide margins; for photographers, artists, architects and galleries. {"roundness":0,"density":0.15,"scale":0.9,"depth":0,"--font-sans":"var(--font-geist), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-instrument-serif), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Maker: warm oat and clay, one earthy accent, soft corners and a friendly grotesk; for ceramics, homeware, bakeries and small makers. {"roundness":0.4,"density":0.35,"scale":0.75,"depth":0,"--font-sans":"var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"600","--hero-entrance":"rise"} - Quiet luxury: ivory and warm near-black, one muted accent, a high-contrast serif and room to breathe; for premium goods, fashion and private services. {"roundness":0.05,"density":0.1,"scale":0.75,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-playfair), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Japanese minimal: rice paper and soft ink, one seal-red accent, a calligraphic serif and wide empty space; for studios, tea, food and wellness. {"roundness":0,"density":0,"scale":0.6,"depth":0,"--font-sans":"ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif","--font-heading":"var(--font-crimson), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"rise"} - Editorial: warm paper and ink-black, one vermilion accent, a large serif over a clean sans, square corners; for writers, magazines and studios. {"roundness":0,"density":0.35,"scale":0.9,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif","--font-heading-weight":"400"} - Corporate: white, blue-grey ink and one deep accent, one sans throughout, modest headings; for firms, finance and anything that must look dependable. {"roundness":0.33,"density":0.55,"scale":0.25,"depth":0.1,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700"} - Dark tech: near-black with fine lines and one bright accent, a geometric sans; for software, developer tools and technical products. {"roundness":0.33,"density":0.6,"scale":0.45,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"} - Playful: cream with saturated colour and black ink, round corners and a chunky sans; for shops, children, food and events. {"roundness":0.66,"density":0.45,"scale":0.8,"depth":0,"--font-sans":"var(--font-nunito), ui-rounded, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"} - Industrial: aged paper and black, one signal colour such as safety orange, square edges and a heavy grotesk at great size; for makers, workshops and engineering. {"roundness":0,"density":0.65,"scale":1,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"unveil"} - Retro print: warm print stock, print-black and one riso ink such as red, a bold slab over a quiet serif; for bookshops, records, posters and local makers. {"roundness":0,"density":0.4,"scale":1,"depth":0,"--font-sans":"var(--font-source-serif), Georgia, serif","--font-heading":"var(--font-bitter), Rockwell, Georgia, serif","--font-heading-weight":"700"} - Cinematic: warm studio paper and black, one electric accent, a tight sans at very large sizes and an opening that unveils; for launches, film and agencies. {"roundness":0.1,"density":0.3,"scale":1,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700","--hero-entrance":"unveil"}
The site's pages that hold some words, best first: titles starting with them, then titles holding them, then descriptions and page text; a question no page holds word for word is matched in English, stems and all. Each with its path, url, title, description and the passage the words are in, the first 20 of `total`: the same rows as the site's search page and /search.json?q=.
| Argument | Type | Description |
|---|---|---|
| site | string | Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token |
| query* | string | The words to find |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"site": {
"type": "string",
"description": "Any live site's address, as acme.miow.me, acme.com or a page's url, to read what anyone can see there without a token"
},
"query": {
"type": "string",
"description": "The words to find"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Put a site nobody owns yet on a domain your human already has; once someone owns the site, its domain is set only from its settings. Returns the DNS records they must set where they bought it: first a TXT record proving the domain is theirs, then the records that point it here. The site moves to the domain once those records are seen; call domain_status to check.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| domain* | string | e.g. example.com |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"domain": {
"type": "string",
"description": "e.g. example.com"
}
}
}Give the site a category tree and make it a wiki, or change its tree. A wiki's pages live in its categories, each with a version and a history of every save, and are written with save_wiki_page, not write_site. The tree is sent whole: each node's slug is its path segment, and its metadataKeys are the facts a page under it carries, a select key becoming a filter on the category's page.
| Argument | Type | Description |
|---|---|---|
| tree* | array | The top-level categories, each with its children |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"$defs": {
"__schema0": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"sort": {
"enum": [
"title",
"recent",
"date"
],
"type": "string"
},
"hidden": {
"type": "boolean",
"description": "Back office: never listed unless asked for by path"
},
"children": {
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
"description": {
"type": "string"
},
"mainArticle": {
"type": "string",
"description": "The article this category is about, as tagPath/slug"
},
"metadataKeys": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label",
"type"
],
"properties": {
"key": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]*$"
},
"type": {
"type": "string",
"pattern": "^[a-z_]+$",
"description": "text, date, url or select; any other type reads as text"
},
"label": {
"type": "string",
"minLength": 1
},
"options": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"description": "The facts a page here carries; select keys become facets"
}
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tree"
],
"properties": {
"tree": {
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
},
"minItems": 1,
"description": "The top-level categories, each with its children"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Put the site back as it was before a change, undoing it and every change since. Take the change id from history. The undo is itself a change, so it can be undone too.
| Argument | Type | Description |
|---|---|---|
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| change_id* | string | From history |
{
"type": "object",
"required": [
"change_id"
],
"properties": {
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"change_id": {
"type": "string",
"description": "From history"
}
}
}Copy an image from a URL into miow's store and get back the URL to use in a pictures block. Up to 10 MB. Use it for an image on someone else's server, which may move or vanish.
| Argument | Type | Description |
|---|---|---|
| url* | string | https URL of the image |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https URL of the image"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}A wiki page's revisions, newest first: version, kind of change, message, who and when, and what each changed block by block. Pass a revision id to restore_wiki_page to put the page back as it was.
| Argument | Type | Description |
|---|---|---|
| path* | string | "" for the home page, a category's path for its hub, else <category path>/<slug> |
| limit | number | 1 to 100; 20 if omitted |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "\"\" for the home page, a category's path for its hub, else <category path>/<slug>"
},
"limit": {
"type": "number",
"description": "1 to 100; 20 if omitted"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
}
}
}Create or replace pages, each sent whole, and delete others; optionally rename the site, change its theme, or set its header, replaced whole. A page you do not send is left as it is. Every write can be undone (history, undo). The input schema gives every block's fields. Pages - path "" is the home page and must exist. Other paths are lowercase slugs, slash-separated, no leading slash. - navOrder places a page in the header nav (0 first); null keeps it out. The home page is reached by the site name, so give it null. - path "search" is the site's search results page, which every site has; no page takes it. - path "_footer" is not a page to visit but the footer shown under every page: addresses, hours, contact details. Content, locations and columns blocks, no hero and no h1, navOrder null. A site without one has no footer. - description is the page's search snippet: one sentence, under 160 characters. - Omit the id of a block you add, and keep every id a page was read with, so a wiki page's history matches its blocks one for one. Blocks - A page is a list of blocks, stacked vertically. Every page has exactly one h1: an opening hero's heading, a product's or a products list's with a menu, or else an h1 at the top of its first content block. - "hero" is a heading, a sentence or two of plain text, and optionally one button. It opens a page, its heading the h1: use one on the home page and on pages that sell something. With "call": true it is a call to action further down instead, its heading an h2: at most one on a page, usually last, asking for one action, with a button. Its heading and text are plain text that may wrap words in <strong> or <em>, as the source sets them bold or italic, and its text may link words with <a href>, as the source links them; words in <strong> in its heading are also drawn in the accent colour. Its optional image is a picture filling it behind the words, by https URL, under the same rule as a pictures block. Where its words are a subheading rather than a sentence (a line or two, often set as headings at the source), give "subheading": true. With no picture, "backdrop": "mesh", "grain", "flow" or "marble" sets a slowly moving field of the site's own colours behind the words, smooth, grainy, folding like poured paint, or hard-edged as marbled paper, and "backdropSpeed" and "backdropIntensity", each 0 to 1, set how fast it moves (0.25 unset) and how strongly it folds (0.5 unset): at most one on a site, on the home page's opening, for a brief that wants a modern or striking look, and never on a site moved across from elsewhere. Over a picture or backdrop its words sit on boxes of the page's background; "box": "panel" or "accent" sets them on that colour instead, and "none" sets light words on the picture itself. - "content" holds HTML, plain and semantic: h1–h4, p, ul, ol, li, a, strong, em, blockquote, table, hr. No class, style or script: they are stripped. No img either: a picture goes in a pictures block. After a hero, headings start at h2. - "columns" sets 2–4 columns side by side, each {"blocks": [...]} of the blocks a column may hold (content, pictures, figures, code, link groups, references, notices, lists, events, locations): for features, services or contact details. They stack on a phone. To place them freely instead, as a page builder's grid does, give every column an "area": {"col", "span", "row", "rows"} on twelve columns, rows counted from 1 (up to 12 columns then); cells may sit lower than their neighbours or overlap. With "beside": true and one column, it is a facts panel beside the text instead: on a page about one thing (a product, a place, an organisation), placed before the page's content, its usual content a picture and a two-column table of facts. - "pictures" shows pictures by https URL, {"items": [{"src", "alt": what it shows, "caption"?}]}: one is a figure, several a row the visitor scrolls sideways. A video file is an item with "video": true, its src an MP4, and "poster"?: the picture it shows before it plays. Use only picture and video URLs the brief gives you; never invent one. For any gallery or slideshow on a site being moved across, one pictures block holding each picture once, in order, without the slideshow's counters ("Image 1 of 12") or its thumbnails. A YouTube link is an iframe in a content block. - "product" makes its page one thing for sale: {"images": [https URLs, the first on every listing], "price"?: as it reads ("£2,500"), "sold"?: true, "tags": [the lists it appears in], "text": HTML of what it is (materials, size, year, words about it)}. It draws the page's title as the h1, so the page has no hero; it goes first. One product per page. Write a price as an amount, "£2,500", "$40" or "€12.50", and the product can be bought online once the site takes payment; "from £40" or "POA" keeps it to the Enquire button. Where it is sold elsewhere, as a book is by its publisher, give it "action": {"label": "Buy from Salmon Poetry", "href": the page that sells it}. A service, booked rather than sold (a lesson, a treatment, a consultation), is a product with "service": true, "duration"?: how long it takes as it reads ("1 hour"), and "unit"?: what its price is for as it reads after it ("an hour", "per person"); its button reads Book, and where it is booked elsewhere, "action" goes to that calendar. "sold" on a service means fully booked. - "list" lists pages of the site, read as the page is: {"source": "under", "under"?: a path} the pages directly under it, a section's index page; {"source": "newest", "count"?, "under"?} the most recently changed, a blog's latest posts; {"source": "chosen", "pages": [paths]} those, in order; or {"source": "products", "tag"?} the product and service pages with that tag, or all, newest first. "show": "cards" (the default) draws each page's first picture, title and search snippet, "links" each title with how long ago it changed; products are always cards of their pictures, name and price, cropped square, "shape": "portrait" upright for books and posters, "landscape" wide. A shop with several lists gives each list's products block a "menu" of links to all of them, [{"label": "All", "href": "/shop"}, …], shown down the left; the block then heads the page with its title, so the page needs no other h1. A list is drawn from each page, so never copy a product's pictures, name or price onto another page; list it. - "donate" takes gifts for a charity or a cause: {"amounts": the suggested gifts in one currency, as they read (["£10", "£20"]), "monthly"?: true where donors may give every month as well as once}. The donor may always give an amount of their own. It shows once the site takes payment. Use it only where the brief asks for donations, with the words that ask for them before it. - "stats" sets 1–12 figures in a row, each {"value": as it reads ("1987", "40+"), "label": what it counts}: years open, customers served, awards. Only figures the brief gives. - "testimonial" is one person's words about the business: {"quote": their words exactly, "author": their name, "role"?, "avatarUrl"?: their photo by https URL}. Only quotes the brief gives, never one written for them. - "poem" sets one poem, or a song's words, line for line as written: {"title"?, "text": plain text, a line to a line, a blank line between stanzas, the spaces that indent a line kept, and words set in italic or bold wrapped in <em> or <strong>, "note"?: one line under it, such as where it first appeared}. Verse goes in a poem block, never a content block, whose paragraphs would run its lines together. Copy every word, line break and indent exactly, and only poems you were given. - "events" lists exhibitions, shows, talks or performances, {"upcoming"?: the heading over those to come or on now ("Upcoming exhibitions"; unset, "Upcoming"), "past"?: the heading over those that have ended (unset, "Past"), "items": [{"date": when it starts, as precisely as given, "2026", "2026-11" or "2026-11-12", "end"?: when it ends, written the same way, "text": what it is and where, plain text that may link words with <a href>}]}. Give every event in one block, in any order: the page sets those to come soonest first under one heading and those that have ended latest first under the other, by the day it is read, so an event moves on its own once it ends. Never split a list into upcoming and past by hand, and never write its dates into the text as well. Its headings are h2s, so a page about events opens on an h1 before it. - "locations" sets out where a business is and when it is open, {"heading"?: an h2 over them, "map"?: true to set a map of each address under it, "items": [{"name"?: which one, where it has several ("Covent Garden"), "image"?: a picture of it by https URL, under the same rule as a pictures block, "address"?: plain text, a line to a line, "map"?: the link to it on a map the source gives, "phone"?, "email"?, "hours"?: [{"days": ["mon", …, "sun"], "opens": "08:00", "closes": "18:00"}], "timeZone"?: its IANA zone where it is not in the UK ("America/Los_Angeles"), "note"?: what the hours do not say, plain text ("Closed on bank holidays")}]}. A row of hours for each set of days that keeps the same times, and two rows for a day it closes in the middle of; a day in none reads Closed, and a closing time at or before the opening one is the next morning. The page groups the days ("Mon–Fri 8am–6pm") and says whether each is open now, by its own clock, so never write hours, an address or its phone number into a content block as well. Every shop, studio or office's address and hours go in one, on its contact or visit page and in the footer; a page about several gives every one in one block. Only hours given as regular opening hours: visits by appointment, or a reading on the third Tuesday of the month, are words in a note or a content block. Its names are h2s, or h3s under its heading. - "codeTabs" shows code to copy in tabs, {"tabs": [{"label": "JavaScript", "language"?: "javascript", "code": "…"}]}: for a developer or a product with an API. - "linkGrid" sets groups of links under a heading each, {"intro"?, "groups": [{"heading", "description"?, "links": [{"label", "href"}]}]}: a page of resources, or the places to go next. - "references" lists the sources a page's claims rest on, {"title"?, "items": [{"text": the citation as HTML, "url"?}]}: at the foot of a page that cites them. - "banner" is a notice at the top of a page about the page itself, {"variant": "stub" | "unsourced" | "outdated" | "promotional" | "cleanup" | "coi", "text"?: words in place of the standard notice}: on a wiki, where a page needs work. - "contents" lists links to the page's own sections, its h2s. Use it at the top of a long page with several sections. - "comments" lets visitors comment on the page, each comment shown once an owner approves it. Use it only where the brief asks for comments, usually at the foot of a blog post. - "contact" is a form for a visitor's name, email address and message, which reaches the site's owners privately and never shows on the site. Use it on a contact page, and wherever the brief asks to be written to but gives no address to publish. - "search" is a box that searches the site's pages as a visitor types; Enter opens the site's search page, /search, with every page that matches. Use it on a site of many pages, on the home page or a page of its own. - Any block of the page's own (not one inside columns) may take "band": "panel" or "accent", which sets it on a strip of that colour from edge to edge. Use bands sparingly, to set a section apart; consecutive blocks with the same band read as one section. - A button's href is a page on the site ("/contact"), an https URL, a mailto: or a tel: address. Link between pages with root-relative hrefs, never the full domain. - Write every phone number as a tel: link and every email address as a mailto: link, so a visitor on a phone can tap it. Theme - Each value is a CSS colour, OKLCH preferred, e.g. "oklch(0.72 0.16 40)". Choose what suits the business, and keep text readable on bg (contrast 4.5:1 or better) and muted text still legible. - --font-sans is one of these values, written exactly: Clean: "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif"; Friendly: "ui-rounded, SF Pro Rounded, Nunito, Varela Round, system-ui, sans-serif"; Humanist: "Optima, Candara, Seravek, Gill Sans Nova, Noto Sans, sans-serif"; Classic: "Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif"; Elegant: "Iowan Old Style, Palatino Linotype, Palatino, URW Palladio L, serif"; Typewriter: "ui-monospace, SF Mono, Menlo, Consolas, monospace"; Inter: "var(--font-inter), ui-sans-serif, system-ui, sans-serif"; Geist: "var(--font-geist), ui-sans-serif, system-ui, sans-serif"; DM Sans: "var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif"; Manrope: "var(--font-manrope), ui-sans-serif, system-ui, sans-serif"; Nunito: "var(--font-nunito), ui-rounded, system-ui, sans-serif"; Work Sans: "var(--font-work-sans), ui-sans-serif, system-ui, sans-serif"; Space Grotesk: "var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif"; Bricolage Grotesque: "var(--font-bricolage), ui-sans-serif, system-ui, sans-serif"; Lora: "var(--font-lora), Georgia, serif"; Playfair Display: "var(--font-playfair), Georgia, serif"; Instrument Serif: "var(--font-instrument-serif), Georgia, serif"; Source Serif: "var(--font-source-serif), Georgia, serif"; Crimson Pro: "var(--font-crimson), Georgia, serif"; Bitter: "var(--font-bitter), Rockwell, Georgia, serif"; Young Serif: "var(--font-young-serif), Georgia, serif"; JetBrains Mono: "var(--font-jetbrains), ui-monospace, monospace". The first six use fonts every device has; the rest are web fonts miow serves. Nothing else loads, and a value with quotes is discarded. - roundness, density, scale and depth are numbers from 0 to 1 that shape every page: corners from square to round, spacing from roomy to compact, headings from close to body size to far larger, and shadow from flat to raised. Choose them for the business as you choose its colours; 0.33, 0.5, 0.5 and 0 is a plain, even look. - --hero-entrance makes an opening's words arrive as the page opens: "rise", "focus" or "unveil". Leave it unset unless the business suits motion. - Looks to start from, each its colours in words and the rest of its theme. Where one suits the business, take its theme whole and choose colours that match its words, in the business's own hue: - Gallery: white walls and near-black ink, one quiet accent, a slim display serif over a clean sans, square corners and wide margins; for photographers, artists, architects and galleries. {"roundness":0,"density":0.15,"scale":0.9,"depth":0,"--font-sans":"var(--font-geist), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-instrument-serif), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Maker: warm oat and clay, one earthy accent, soft corners and a friendly grotesk; for ceramics, homeware, bakeries and small makers. {"roundness":0.4,"density":0.35,"scale":0.75,"depth":0,"--font-sans":"var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"600","--hero-entrance":"rise"} - Quiet luxury: ivory and warm near-black, one muted accent, a high-contrast serif and room to breathe; for premium goods, fashion and private services. {"roundness":0.05,"density":0.1,"scale":0.75,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-playfair), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Japanese minimal: rice paper and soft ink, one seal-red accent, a calligraphic serif and wide empty space; for studios, tea, food and wellness. {"roundness":0,"density":0,"scale":0.6,"depth":0,"--font-sans":"ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif","--font-heading":"var(--font-crimson), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"rise"} - Editorial: warm paper and ink-black, one vermilion accent, a large serif over a clean sans, square corners; for writers, magazines and studios. {"roundness":0,"density":0.35,"scale":0.9,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif","--font-heading-weight":"400"} - Corporate: white, blue-grey ink and one deep accent, one sans throughout, modest headings; for firms, finance and anything that must look dependable. {"roundness":0.33,"density":0.55,"scale":0.25,"depth":0.1,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700"} - Dark tech: near-black with fine lines and one bright accent, a geometric sans; for software, developer tools and technical products. {"roundness":0.33,"density":0.6,"scale":0.45,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"} - Playful: cream with saturated colour and black ink, round corners and a chunky sans; for shops, children, food and events. {"roundness":0.66,"density":0.45,"scale":0.8,"depth":0,"--font-sans":"var(--font-nunito), ui-rounded, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"} - Industrial: aged paper and black, one signal colour such as safety orange, square edges and a heavy grotesk at great size; for makers, workshops and engineering. {"roundness":0,"density":0.65,"scale":1,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"unveil"} - Retro print: warm print stock, print-black and one riso ink such as red, a bold slab over a quiet serif; for bookshops, records, posters and local makers. {"roundness":0,"density":0.4,"scale":1,"depth":0,"--font-sans":"var(--font-source-serif), Georgia, serif","--font-heading":"var(--font-bitter), Rockwell, Georgia, serif","--font-heading-weight":"700"} - Cinematic: warm studio paper and black, one electric accent, a tight sans at very large sizes and an opening that unveils; for launches, film and agencies. {"roundness":0.1,"density":0.3,"scale":1,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700","--hero-entrance":"unveil"} Copy - Most visitors read on a phone. Short paragraphs, plain words, the important thing first. - Write in the business's own voice, from what you were given. - Every claim must come from what you were given: the brief, the owner's own words, or their current site. That covers the obvious (prices, addresses, phone numbers, opening hours, testimonials, staff) and the easy to slip in: named products, how things are made ("by hand", "local ingredients"), delivery terms, service areas, and the business's name. Where you were given no name, use the plainest description of the business. - A thin brief makes a short site. One honest page beats four padded ones; never fill a page to make it look complete. Images: upload_image first, then use the URL it returns.
| Argument | Type | Description |
|---|---|---|
| path* | string | The page's address without its slashes: "" for the home page, a category's path for its hub article, else category path + "/" + slug |
| title | string | Required for a new page |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| content | array | The page's blocks, whole. Required for a new page; omit to keep them |
| message | string | What this change does, for the page's history |
| metadata | object | Replaces the page's metadata whole: the facts its category declares, and `description`, its search snippet |
| new_slug | string | Moves the page to this slug in its category |
| base_version | string | The version you read. A save over a page that has moved on since is refused, so read it again |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "The page's address without its slashes: \"\" for the home page, a category's path for its hub article, else category path + \"/\" + slug"
},
"title": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Required for a new page"
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"content": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
},
"type": {
"type": "string",
"const": "content"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"src",
"alt"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"video": {
"type": "boolean",
"const": true,
"description": "src is an MP4 file that plays"
},
"poster": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A video's picture before it plays"
},
"caption": {
"type": "string"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
}
}
},
{
"type": "object",
"required": [
"type",
"tabs"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"tabs": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"code"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
}
}
},
"maxItems": 8,
"minItems": 1
},
"type": {
"type": "string",
"const": "codeTabs"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"label": {
"type": "string",
"minLength": 1
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"suffix": {
"type": "string"
}
}
},
"maxItems": 12,
"minItems": 1
},
"columns": {
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
],
"description": "How many to a row; unset, as many as fit"
}
}
},
{
"type": "object",
"required": [
"type",
"groups"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"heading",
"links"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
}
},
"heading": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
],
"description": "Plain semantic HTML"
}
}
},
"minItems": 1,
"description": "Groups of links under a heading each"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "references"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
}
}
},
"minItems": 1
},
"title": {
"type": "string",
"description": "Its heading; unset, \"References\""
}
}
},
{
"type": "object",
"required": [
"type",
"variant"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"text": {
"type": "string",
"description": "Words in place of the notice's standard ones"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"type": "string",
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
}
}
},
{
"type": "object",
"required": [
"type",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tag": {
"type": "string",
"description": "With \"products\", only those with this tag; omit for all"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"menu": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 24,
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title"
},
"show": {
"enum": [
"cards",
"links"
],
"type": "string",
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards"
},
"type": {
"type": "string",
"const": "list"
},
"count": {
"type": "integer",
"maximum": 48,
"minimum": 1,
"description": "With \"newest\", how many; unset, 6"
},
"pages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$"
},
"maxItems": 48,
"description": "With \"chosen\", the pages by path, in the order they are listed"
},
"shape": {
"enum": [
"portrait",
"landscape"
],
"type": "string",
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages"
},
"under": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$",
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site"
},
"source": {
"enum": [
"under",
"newest",
"chosen",
"products"
],
"type": "string",
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"past": {
"type": "string",
"description": "The heading over those that have ended; unset, \"Past\""
},
"type": {
"type": "string",
"const": "events"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"end": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it ends, written as date is; unset, it ends when it starts"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
}
},
"maxItems": 300,
"minItems": 1,
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
},
"upcoming": {
"type": "string",
"description": "The heading over those to come or on now; unset, \"Upcoming\""
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "boolean",
"const": true,
"description": "A map of each address, set under it"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "locations"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$",
"description": "A link to the place on a map, as the business gives it; unset, a search for the address"
},
"name": {
"type": "string",
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one"
},
"note": {
"type": "string",
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"opens",
"closes"
],
"properties": {
"days": {
"type": "array",
"items": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string"
},
"minItems": 1,
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
}
},
"maxItems": 21,
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture of it, by https URL"
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$",
"description": "As it reads: \"020 7232 3010\""
},
"address": {
"type": "string",
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\""
},
"timeZone": {
"type": "string",
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\""
}
}
},
"maxItems": 100,
"minItems": 1
},
"heading": {
"type": "string",
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2"
}
}
},
{
"type": "object",
"required": [
"type",
"columns"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"gap": {
"enum": [
"sm",
"md",
"lg"
],
"type": "string"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "columns"
},
"align": {
"enum": [
"start",
"center",
"end",
"stretch"
],
"type": "string"
},
"beside": {
"type": "boolean",
"const": true,
"description": "Set as one panel beside the text, its columns stacked in it: a facts panel on a page about one thing, placed before its content"
},
"columns": {
"type": "array",
"items": {
"type": "object",
"required": [
"blocks"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"area": {
"type": "object",
"required": [
"col",
"span",
"row",
"rows"
],
"properties": {
"col": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"row": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"rows": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"span": {
"type": "integer",
"maximum": 12,
"minimum": 1
}
},
"description": "Its place on a twelve-column grid; give every column one, or none"
},
"blocks": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
},
"type": {
"type": "string",
"const": "content"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"src",
"alt"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"video": {
"type": "boolean",
"const": true,
"description": "src is an MP4 file that plays"
},
"poster": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A video's picture before it plays"
},
"caption": {
"type": "string"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
}
}
},
{
"type": "object",
"required": [
"type",
"tabs"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tabs": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"code"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
}
}
},
"maxItems": 8,
"minItems": 1
},
"type": {
"type": "string",
"const": "codeTabs"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"label": {
"type": "string",
"minLength": 1
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"suffix": {
"type": "string"
}
}
},
"maxItems": 12,
"minItems": 1
},
"columns": {
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
],
"description": "How many to a row; unset, as many as fit"
}
}
},
{
"type": "object",
"required": [
"type",
"groups"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"heading",
"links"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
}
},
"heading": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
],
"description": "Plain semantic HTML"
}
}
},
"minItems": 1,
"description": "Groups of links under a heading each"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "references"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
}
}
},
"minItems": 1
},
"title": {
"type": "string",
"description": "Its heading; unset, \"References\""
}
}
},
{
"type": "object",
"required": [
"type",
"variant"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"text": {
"type": "string",
"description": "Words in place of the notice's standard ones"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"type": "string",
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
}
}
},
{
"type": "object",
"required": [
"type",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tag": {
"type": "string",
"description": "With \"products\", only those with this tag; omit for all"
},
"menu": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 24,
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title"
},
"show": {
"enum": [
"cards",
"links"
],
"type": "string",
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards"
},
"type": {
"type": "string",
"const": "list"
},
"count": {
"type": "integer",
"maximum": 48,
"minimum": 1,
"description": "With \"newest\", how many; unset, 6"
},
"pages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$"
},
"maxItems": 48,
"description": "With \"chosen\", the pages by path, in the order they are listed"
},
"shape": {
"enum": [
"portrait",
"landscape"
],
"type": "string",
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages"
},
"under": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$",
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site"
},
"source": {
"enum": [
"under",
"newest",
"chosen",
"products"
],
"type": "string",
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"past": {
"type": "string",
"description": "The heading over those that have ended; unset, \"Past\""
},
"type": {
"type": "string",
"const": "events"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"end": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it ends, written as date is; unset, it ends when it starts"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
}
},
"maxItems": 300,
"minItems": 1,
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
},
"upcoming": {
"type": "string",
"description": "The heading over those to come or on now; unset, \"Upcoming\""
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "boolean",
"const": true,
"description": "A map of each address, set under it"
},
"type": {
"type": "string",
"const": "locations"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$",
"description": "A link to the place on a map, as the business gives it; unset, a search for the address"
},
"name": {
"type": "string",
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one"
},
"note": {
"type": "string",
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"opens",
"closes"
],
"properties": {
"days": {
"type": "array",
"items": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string"
},
"minItems": 1,
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
}
},
"maxItems": 21,
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture of it, by https URL"
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$",
"description": "As it reads: \"020 7232 3010\""
},
"address": {
"type": "string",
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\""
},
"timeZone": {
"type": "string",
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\""
}
}
},
"maxItems": 100,
"minItems": 1
},
"heading": {
"type": "string",
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2"
}
}
}
]
}
}
}
},
"maxItems": 12,
"minItems": 1
}
}
},
{
"type": "object",
"required": [
"type",
"heading"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"box": {
"enum": [
"panel",
"accent",
"none"
],
"type": "string",
"description": "Over a picture or backdrop, what the words sit on: unset, boxes of the page's background; \"panel\" or \"accent\" boxes of that colour; \"none\" no box, light words straight on the picture"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"call": {
"type": "boolean",
"const": true,
"description": "A call to action further down the page rather than its opening: its heading an h2, set smaller"
},
"text": {
"type": "string",
"description": "Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"type": {
"type": "string",
"const": "hero"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture behind the heading, by https URL"
},
"action": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"heading": {
"type": "string",
"description": "Plain text; words may be wrapped in <strong> or <em>; words in <strong> are drawn in the accent colour"
},
"backdrop": {
"enum": [
"mesh",
"grain",
"flow",
"marble"
],
"type": "string",
"description": "With no picture, a slowly moving field of the site's own colours behind the heading: \"mesh\" smooth, \"grain\" grainy as print, \"flow\" folding like poured paint, \"marble\" hard-edged as marbled paper"
},
"subheading": {
"type": "boolean",
"description": "Its text is a subheading, set in the headings' font, each line on its own"
},
"backdropSpeed": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How fast the backdrop moves: 0 still, 1 fast; unset, 0.25, slowly"
},
"backdropIntensity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How strongly the backdrop swirls and folds: 0 gently, 1 wildly; unset, 0.5"
}
}
},
{
"type": "object",
"required": [
"type",
"images",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"sold": {
"type": "boolean",
"description": "A thing sold, or a service fully booked"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"default": [],
"description": "The listings it appears in, by their \"tag\""
},
"text": {
"type": "string",
"description": "Plain semantic HTML: materials, size, year, what it is; for a service, what it involves"
},
"type": {
"type": "string",
"const": "product"
},
"unit": {
"type": "string",
"maxLength": 40,
"description": "With \"service\", what the price is for, as it reads after it: \"an hour\", \"a session\", \"per person\"; bought online, the buyer says how many"
},
"price": {
"type": "string",
"description": "As it should read, currency included: \"£2,500\""
},
"action": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
},
"description": "A button of its own, to where it is sold or booked elsewhere: a publisher's or a gallery's page, a booking calendar"
},
"images": {
"type": "array",
"items": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"description": "Its pictures by https URL, the first on every listing"
},
"service": {
"type": "boolean",
"const": true,
"description": "It is a service, booked rather than sold: a lesson, a treatment, a consultation"
},
"duration": {
"type": "string",
"maxLength": 40,
"description": "With \"service\", how long it takes, as it reads: \"1 hour\", \"Half a day\""
}
}
},
{
"type": "object",
"required": [
"type",
"amounts"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "donate"
},
"amounts": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"description": "The suggested gifts as they read, in one currency: [\"£10\", \"£20\"]; the donor may also give their own"
},
"monthly": {
"type": "boolean",
"description": "The donor may give it every month as well as once"
}
}
},
{
"type": "object",
"required": [
"type",
"quote",
"author"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"role": {
"type": "string",
"description": "Who they are: \"Bride, 2024\", \"Head chef, The Ivy\""
},
"type": {
"type": "string",
"const": "testimonial"
},
"quote": {
"type": "string",
"minLength": 1,
"description": "Their words, exactly"
},
"author": {
"type": "string",
"minLength": 1,
"description": "Their name"
},
"avatarUrl": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "Their photo, by https URL"
}
}
},
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"note": {
"type": "string",
"description": "A line under it: where it first appeared, \"From Wringing Blood (Shoestring Press, 2013)\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "Plain text as set: a line to a line, a blank line between stanzas, the spaces that indent a line kept; words may be wrapped in <strong> or <em>"
},
"type": {
"type": "string",
"const": "poem"
},
"title": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "contents"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "search"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "comments"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "contact"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "start"
}
},
"description": "miow.me's own home page editor; never on another site"
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "pricing"
},
"heading": {
"type": "string"
}
},
"description": "miow.me's own hosting prices; never on another site"
}
]
},
"maxItems": 500,
"description": "The page's blocks, whole. Required for a new page; omit to keep them"
},
"message": {
"type": "string",
"maxLength": 300,
"description": "What this change does, for the page's history"
},
"metadata": {
"type": "object",
"description": "Replaces the page's metadata whole: the facts its category declares, and `description`, its search snippet",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"new_slug": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"description": "Moves the page to this slug in its category"
},
"base_version": {
"type": "string",
"description": "The version you read. A save over a page that has moved on since is refused, so read it again"
}
}
}| Argument | Type | Description |
|---|---|---|
| name | string | A new name for the site |
| pages | array | Pages to create or replace, each whole |
| theme | object | Keys to change. hue, chroma, tone and contrast, sent together, derive all six colours and replace those set before; a colour sent beside them is kept over it. |
| token | string | The site token from create_site or the site's settings. Omit if your Authorization header carries it. |
| delete | array | Paths of pages to remove |
| header | object | Replaces the header whole; {} clears it |
| summary* | string | What this change does, in a few words, for the history |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"summary"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A new name for the site"
},
"pages": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"title",
"content"
],
"properties": {
"path": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$",
"description": "\"\" is the home page; else slash-separated slugs, no leading slash, never \"search\" or \"mcp\""
},
"image": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
{
"type": "null"
}
],
"default": null,
"description": "The picture a link to the page shows in a chat or a feed, by https URL, cropped to 1200×630; null draws a card of the page's title over its first picture or the site's colours"
},
"title": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"content": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
},
"type": {
"type": "string",
"const": "content"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"src",
"alt"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"video": {
"type": "boolean",
"const": true,
"description": "src is an MP4 file that plays"
},
"poster": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A video's picture before it plays"
},
"caption": {
"type": "string"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
}
}
},
{
"type": "object",
"required": [
"type",
"tabs"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"tabs": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"code"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
}
}
},
"maxItems": 8,
"minItems": 1
},
"type": {
"type": "string",
"const": "codeTabs"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"label": {
"type": "string",
"minLength": 1
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"suffix": {
"type": "string"
}
}
},
"maxItems": 12,
"minItems": 1
},
"columns": {
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
],
"description": "How many to a row; unset, as many as fit"
}
}
},
{
"type": "object",
"required": [
"type",
"groups"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"heading",
"links"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
}
},
"heading": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
],
"description": "Plain semantic HTML"
}
}
},
"minItems": 1,
"description": "Groups of links under a heading each"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "references"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
}
}
},
"minItems": 1
},
"title": {
"type": "string",
"description": "Its heading; unset, \"References\""
}
}
},
{
"type": "object",
"required": [
"type",
"variant"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"text": {
"type": "string",
"description": "Words in place of the notice's standard ones"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"type": "string",
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
}
}
},
{
"type": "object",
"required": [
"type",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tag": {
"type": "string",
"description": "With \"products\", only those with this tag; omit for all"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"menu": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 24,
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title"
},
"show": {
"enum": [
"cards",
"links"
],
"type": "string",
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards"
},
"type": {
"type": "string",
"const": "list"
},
"count": {
"type": "integer",
"maximum": 48,
"minimum": 1,
"description": "With \"newest\", how many; unset, 6"
},
"pages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$"
},
"maxItems": 48,
"description": "With \"chosen\", the pages by path, in the order they are listed"
},
"shape": {
"enum": [
"portrait",
"landscape"
],
"type": "string",
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages"
},
"under": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$",
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site"
},
"source": {
"enum": [
"under",
"newest",
"chosen",
"products"
],
"type": "string",
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"past": {
"type": "string",
"description": "The heading over those that have ended; unset, \"Past\""
},
"type": {
"type": "string",
"const": "events"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"end": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it ends, written as date is; unset, it ends when it starts"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
}
},
"maxItems": 300,
"minItems": 1,
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
},
"upcoming": {
"type": "string",
"description": "The heading over those to come or on now; unset, \"Upcoming\""
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "boolean",
"const": true,
"description": "A map of each address, set under it"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "locations"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$",
"description": "A link to the place on a map, as the business gives it; unset, a search for the address"
},
"name": {
"type": "string",
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one"
},
"note": {
"type": "string",
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"opens",
"closes"
],
"properties": {
"days": {
"type": "array",
"items": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string"
},
"minItems": 1,
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
}
},
"maxItems": 21,
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture of it, by https URL"
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$",
"description": "As it reads: \"020 7232 3010\""
},
"address": {
"type": "string",
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\""
},
"timeZone": {
"type": "string",
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\""
}
}
},
"maxItems": 100,
"minItems": 1
},
"heading": {
"type": "string",
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2"
}
}
},
{
"type": "object",
"required": [
"type",
"columns"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"gap": {
"enum": [
"sm",
"md",
"lg"
],
"type": "string"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "columns"
},
"align": {
"enum": [
"start",
"center",
"end",
"stretch"
],
"type": "string"
},
"beside": {
"type": "boolean",
"const": true,
"description": "Set as one panel beside the text, its columns stacked in it: a facts panel on a page about one thing, placed before its content"
},
"columns": {
"type": "array",
"items": {
"type": "object",
"required": [
"blocks"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"area": {
"type": "object",
"required": [
"col",
"span",
"row",
"rows"
],
"properties": {
"col": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"row": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"rows": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"span": {
"type": "integer",
"maximum": 12,
"minimum": 1
}
},
"description": "Its place on a twelve-column grid; give every column one, or none"
},
"blocks": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
},
"type": {
"type": "string",
"const": "content"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"src",
"alt"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"video": {
"type": "boolean",
"const": true,
"description": "src is an MP4 file that plays"
},
"poster": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A video's picture before it plays"
},
"caption": {
"type": "string"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
}
}
},
{
"type": "object",
"required": [
"type",
"tabs"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tabs": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"code"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
}
}
},
"maxItems": 8,
"minItems": 1
},
"type": {
"type": "string",
"const": "codeTabs"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"label": {
"type": "string",
"minLength": 1
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"suffix": {
"type": "string"
}
}
},
"maxItems": 12,
"minItems": 1
},
"columns": {
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
],
"description": "How many to a row; unset, as many as fit"
}
}
},
{
"type": "object",
"required": [
"type",
"groups"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"heading",
"links"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
}
},
"heading": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
],
"description": "Plain semantic HTML"
}
}
},
"minItems": 1,
"description": "Groups of links under a heading each"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"type": {
"type": "string",
"const": "references"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
}
}
},
"minItems": 1
},
"title": {
"type": "string",
"description": "Its heading; unset, \"References\""
}
}
},
{
"type": "object",
"required": [
"type",
"variant"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"text": {
"type": "string",
"description": "Words in place of the notice's standard ones"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"type": "string",
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
}
}
},
{
"type": "object",
"required": [
"type",
"source"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"tag": {
"type": "string",
"description": "With \"products\", only those with this tag; omit for all"
},
"menu": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 24,
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title"
},
"show": {
"enum": [
"cards",
"links"
],
"type": "string",
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards"
},
"type": {
"type": "string",
"const": "list"
},
"count": {
"type": "integer",
"maximum": 48,
"minimum": 1,
"description": "With \"newest\", how many; unset, 6"
},
"pages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$"
},
"maxItems": 48,
"description": "With \"chosen\", the pages by path, in the order they are listed"
},
"shape": {
"enum": [
"portrait",
"landscape"
],
"type": "string",
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages"
},
"under": {
"type": "string",
"pattern": "^(?!(?:search|mcp)$)(?:[A-Za-z0-9_~-]+(?:\\/[A-Za-z0-9_~-]+)*)?$",
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site"
},
"source": {
"enum": [
"under",
"newest",
"chosen",
"products"
],
"type": "string",
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"past": {
"type": "string",
"description": "The heading over those that have ended; unset, \"Past\""
},
"type": {
"type": "string",
"const": "events"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"end": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it ends, written as date is; unset, it ends when it starts"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
}
},
"maxItems": 300,
"minItems": 1,
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
},
"upcoming": {
"type": "string",
"description": "The heading over those to come or on now; unset, \"Upcoming\""
}
}
},
{
"type": "object",
"required": [
"type",
"items"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "boolean",
"const": true,
"description": "A map of each address, set under it"
},
"type": {
"type": "string",
"const": "locations"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"map": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$",
"description": "A link to the place on a map, as the business gives it; unset, a search for the address"
},
"name": {
"type": "string",
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one"
},
"note": {
"type": "string",
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"opens",
"closes"
],
"properties": {
"days": {
"type": "array",
"items": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string"
},
"minItems": 1,
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
}
},
"maxItems": 21,
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture of it, by https URL"
},
"phone": {
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$",
"description": "As it reads: \"020 7232 3010\""
},
"address": {
"type": "string",
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\""
},
"timeZone": {
"type": "string",
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\""
}
}
},
"maxItems": 100,
"minItems": 1
},
"heading": {
"type": "string",
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2"
}
}
}
]
}
}
}
},
"maxItems": 12,
"minItems": 1
}
}
},
{
"type": "object",
"required": [
"type",
"heading"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"box": {
"enum": [
"panel",
"accent",
"none"
],
"type": "string",
"description": "Over a picture or backdrop, what the words sit on: unset, boxes of the page's background; \"panel\" or \"accent\" boxes of that colour; \"none\" no box, light words straight on the picture"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"call": {
"type": "boolean",
"const": true,
"description": "A call to action further down the page rather than its opening: its heading an h2, set smaller"
},
"text": {
"type": "string",
"description": "Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
},
"type": {
"type": "string",
"const": "hero"
},
"image": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A picture behind the heading, by https URL"
},
"action": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
}
},
"heading": {
"type": "string",
"description": "Plain text; words may be wrapped in <strong> or <em>; words in <strong> are drawn in the accent colour"
},
"backdrop": {
"enum": [
"mesh",
"grain",
"flow",
"marble"
],
"type": "string",
"description": "With no picture, a slowly moving field of the site's own colours behind the heading: \"mesh\" smooth, \"grain\" grainy as print, \"flow\" folding like poured paint, \"marble\" hard-edged as marbled paper"
},
"subheading": {
"type": "boolean",
"description": "Its text is a subheading, set in the headings' font, each line on its own"
},
"backdropSpeed": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How fast the backdrop moves: 0 still, 1 fast; unset, 0.25, slowly"
},
"backdropIntensity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How strongly the backdrop swirls and folds: 0 gently, 1 wildly; unset, 0.5"
}
}
},
{
"type": "object",
"required": [
"type",
"images",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"sold": {
"type": "boolean",
"description": "A thing sold, or a service fully booked"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"default": [],
"description": "The listings it appears in, by their \"tag\""
},
"text": {
"type": "string",
"description": "Plain semantic HTML: materials, size, year, what it is; for a service, what it involves"
},
"type": {
"type": "string",
"const": "product"
},
"unit": {
"type": "string",
"maxLength": 40,
"description": "With \"service\", what the price is for, as it reads after it: \"an hour\", \"a session\", \"per person\"; bought online, the buyer says how many"
},
"price": {
"type": "string",
"description": "As it should read, currency included: \"£2,500\""
},
"action": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
},
"description": "A button of its own, to where it is sold or booked elsewhere: a publisher's or a gallery's page, a booking calendar"
},
"images": {
"type": "array",
"items": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"description": "Its pictures by https URL, the first on every listing"
},
"service": {
"type": "boolean",
"const": true,
"description": "It is a service, booked rather than sold: a lesson, a treatment, a consultation"
},
"duration": {
"type": "string",
"maxLength": 40,
"description": "With \"service\", how long it takes, as it reads: \"1 hour\", \"Half a day\""
}
}
},
{
"type": "object",
"required": [
"type",
"amounts"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "donate"
},
"amounts": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"description": "The suggested gifts as they read, in one currency: [\"£10\", \"£20\"]; the donor may also give their own"
},
"monthly": {
"type": "boolean",
"description": "The donor may give it every month as well as once"
}
}
},
{
"type": "object",
"required": [
"type",
"quote",
"author"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"role": {
"type": "string",
"description": "Who they are: \"Bride, 2024\", \"Head chef, The Ivy\""
},
"type": {
"type": "string",
"const": "testimonial"
},
"quote": {
"type": "string",
"minLength": 1,
"description": "Their words, exactly"
},
"author": {
"type": "string",
"minLength": 1,
"description": "Their name"
},
"avatarUrl": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "Their photo, by https URL"
}
}
},
{
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"note": {
"type": "string",
"description": "A line under it: where it first appeared, \"From Wringing Blood (Shoestring Press, 2013)\""
},
"text": {
"type": "string",
"minLength": 1,
"description": "Plain text as set: a line to a line, a blank line between stanzas, the spaces that indent a line kept; words may be wrapped in <strong> or <em>"
},
"type": {
"type": "string",
"const": "poem"
},
"title": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "contents"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "search"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "comments"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "contact"
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "start"
}
},
"description": "miow.me's own home page editor; never on another site"
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Omit on a new block, keep as read on one you send back; assigned on write"
},
"band": {
"enum": [
"panel",
"accent"
],
"type": "string",
"description": "A full-width strip of the panel or the accent colour behind the block"
},
"type": {
"type": "string",
"const": "pricing"
},
"heading": {
"type": "string"
}
},
"description": "miow.me's own hosting prices; never on another site"
}
]
},
"maxItems": 500
},
"navOrder": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"default": null,
"description": "Position in the header nav, 0 first; null keeps it out"
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"default": null,
"description": "Search snippet: one sentence under 160 characters"
}
}
},
"maxItems": 2000,
"description": "Pages to create or replace, each whole"
},
"theme": {
"type": "object",
"properties": {
"hue": {
"type": "number",
"maximum": 360,
"minimum": 0,
"description": "The accent colour, as an OKLCH hue in degrees"
},
"tone": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "0 a dark site, 1 a light one"
},
"depth": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Shadow under buttons and panels: 0 flat, 1 raised"
},
"scale": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Headings against body text: 0 close in size, 1 far larger"
},
"chroma": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How colourful the accent is; the rest is tinted with it faintly"
},
"density": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Space between and around blocks: 0 roomy, 1 compact"
},
"contrast": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "How far text and lines stand from the background"
},
"roundness": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Corners of buttons, pictures and panels: 0 square, 1 round"
},
"--color-bg": {
"type": "string"
},
"--font-nav": {
"type": "string",
"description": "The header menu's font, written as --font-sans is; unset, --font-header's"
},
"--nav-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of the header menu on a laptop, \"1.2rem\"; unset, the text's"
},
"adobeFonts": {
"type": "string",
"pattern": "^(?:[a-z0-9]{5,12})?$",
"description": "The id of the site's own Adobe Fonts web project, from its embed code use.typekit.net/<id>.css; \"\" removes it"
},
"--color-nav": {
"type": "string",
"description": "The menu's colour; unset, the headings'"
},
"--font-name": {
"type": "string",
"description": "The site's name in a font of its own, written as --font-sans is; unset, --font-header's"
},
"--font-sans": {
"type": "string"
},
"--hero-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of an opening's heading on a laptop, \"3rem\"; unset, it grows with the window"
},
"--logo-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The height of the logo in the header, \"5rem\"; unset, 3rem"
},
"--name-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of the site's name in the header on a laptop, \"1.8rem\"; unset, the text's"
},
"--text-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of body text on a laptop, every heading reckoned from it, \"1.2rem\"; unset, 1rem"
},
"--color-name": {
"type": "string",
"description": "The name's colour; unset, the headings'"
},
"--color-text": {
"type": "string"
},
"--nav-weight": {
"type": "string",
"pattern": "^(?:[1-9]00)?$",
"description": "The menu's weight; unset, the headings'"
},
"--page-width": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "With the header's \"wide\", how wide pages may grow, \"93.75rem\"; unset, 112.5rem"
},
"--color-muted": {
"type": "string"
},
"--font-header": {
"type": "string",
"description": "The font of the site's name and its menu; unset, the headings'"
},
"--name-weight": {
"type": "string",
"pattern": "^(?:[1-9]00)?$",
"description": "The name's weight; unset, the headings'"
},
"--page-margin": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:rem|cqi))?$",
"description": "With \"wide\", the margin either side of the header and pages, \"4cqi\" for 4% of the width; unset, 3cqi"
},
"--color-accent": {
"type": "string"
},
"--color-border": {
"type": "string"
},
"--font-heading": {
"type": "string",
"description": "Headings, and the site's name and menu unless --font-header sets theirs; unset, they take --font-sans"
},
"--tagline-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of the line under the name, \"0.9rem\"; unset, a little under the text's"
},
"--button-radius": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:px|rem)?(?: \\d*\\.?\\d+(?:px|rem)?){0,3})?$",
"description": "Every button's corners as CSS border-radius, \"45px 0\" for a petal, \"0\" square, \"999px\" a pill; unset, from roundness"
},
"--color-heading": {
"type": "string",
"description": "The colour of headings, the site's name and its menu; unset, they take the text's"
},
"--color-tagline": {
"type": "string",
"description": "The line's colour; unset, the quiet text's"
},
"--heading-align": {
"enum": [
"",
"start",
"center",
"end"
],
"type": "string",
"description": "Where the headings in a page's text sit: \"center\" centred; unset, at the start of the line"
},
"--hero-entrance": {
"enum": [
"",
"rise",
"focus",
"unveil"
],
"type": "string",
"description": "How an opening's heading, words and button arrive as the page opens: \"rise\", \"focus\" or \"unveil\"; unset or \"\", at once. A visitor who asks for less motion sees them at once"
},
"--tagline-style": {
"enum": [
"",
"italic"
],
"type": "string",
"description": "\"italic\" sets the line under the name in italic"
},
"--button-padding": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+r?em(?: \\d*\\.?\\d+r?em)?)?$",
"description": "Space inside every button, top and bottom then the sides, \"2rem 3rem\"; unset, from the shape"
},
"--header-padding": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:rem|cqi))?$",
"description": "With \"wide\", the space above and below the header's contents, \"1cqi\"; unset, 2cqi"
},
"--color-surface-1": {
"type": "string"
},
"--heading-tracking": {
"type": "string",
"pattern": "^(?:-?\\d*\\.?\\d+em)?$",
"description": "Space between the letters of headings, \"-0.03em\" tight for a large sans; unset, the font's own"
},
"--color-name-strong": {
"type": "string",
"description": "The colour of the words in <strong> in the header's styledName; unset, the name's"
},
"--font-header-button": {
"type": "string",
"description": "The font of the header's button; unset, the text's"
},
"--header-button-size": {
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$",
"description": "The size of the words on the header's button, \"1.1rem\"; unset, the text's"
},
"--color-header-button": {
"type": "string",
"description": "The header button's colour; unset, the accent"
},
"--font-heading-weight": {
"type": "string",
"pattern": "^(?:[1-9]00)?$",
"description": "Their weight, \"700\" bold; unset, each heading keeps its own"
},
"--color-tagline-strong": {
"type": "string",
"description": "The colour of the words in <strong> in the line; unset, the line's"
},
"--color-header-button-text": {
"type": "string",
"description": "The colour of its words; unset, the background's"
}
},
"description": "Keys to change. hue, chroma, tone and contrast, sent together, derive all six colours and replace those set before; a colour sent beside them is kept over it."
},
"token": {
"type": "string",
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it."
},
"delete": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"maxItems": 2000,
"description": "Paths of pages to remove"
},
"header": {
"type": "object",
"properties": {
"logo": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "A logo shown before the name, by https URL"
},
"menu": {
"enum": [
"side",
"start",
"center"
],
"type": "string",
"description": "\"side\" puts the name and menu down the left from a laptop up; across the top, \"start\" sets the menu just after the name and \"center\" in the middle; unset, at the end"
},
"wide": {
"type": "boolean",
"description": "The header, pages and footer run the window's width, their margins growing with it, as a page builder's do; unset, they keep to a column"
},
"action": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"label": {
"type": "string",
"minLength": 1
}
},
"description": "One button at the far end of the header"
},
"search": {
"type": "boolean",
"description": "A search field in the header, finding any of the site's pages by its words"
},
"shadow": {
"type": "boolean",
"description": "A shadow under the header in place of its line"
},
"social": {
"type": "array",
"items": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"maxItems": 8,
"description": "The site's own profiles elsewhere, by https URL, each an icon at the end of the header: Instagram, Facebook, X, YouTube, LinkedIn or any other"
},
"sticky": {
"type": "boolean",
"description": "The header stays at the top of the window as the page scrolls"
},
"enquire": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$",
"description": "Where every product's Enquire button goes: a mailto:, tel: or page; unset, products have none"
},
"tagline": {
"type": "string",
"description": "A short line under the name: Plain text; words may be wrapped in <strong> or <em>"
},
"styledName": {
"type": "string",
"description": "The site's name as the header draws it: Plain text; words may be wrapped in <strong> or <em>. Shown only while its words are the site's name"
}
},
"description": "Replaces the header whole; {} clears it"
},
"summary": {
"type": "string",
"description": "What this change does, in a few words, for the history"
}
}
}