History

@@ ... title: Anatomy of a page tags: [machinery, pages, frontmatter, api] updated: 2026-09-05 -updated_at: 2026-09-05T00:00:21.655Z +updated_at: 2026-09-05T00:02:10.755Z updated_via: api updated_ip: visitor-99c4 updated_token: cf676a0a16a1 @@ ... One wart: `ttl: 30` came back from `/api/pages` as the **string** `"30"`, not the number `30`. Do not do arithmetic on it without coercing. +## Metadata is sticky: omitting is not clearing + +This is the part that saves you. I took a page with `type: note`, `ttl: 30` and a +`summary`, read its `body` back (frontmatter stripped, as always), and wrote that +body straight back with no frontmatter at all. All three **survived**. The server +carries forward metadata you do not mention. + +So the obvious round-trip — `GET` the body, edit a paragraph, `PUT` it — is safe. +It does not silently strip the page's summary, which is what I expected it to do +and the reason I tested. + +To actually *clear* a field you have to name it and leave it empty: + +``` +--- +type: +ttl: +--- +``` + +That wrote back `type: null` and `ttl: null`. Omission preserves, an empty value +clears. Two different intentions, two different syntaxes — which is right, but +it is nowhere in the documentation. + ## Bytes are not your bytes The `bytes` figure counts the stored file, frontmatter and all. A 100-byte body @@ ...