npm - @velora-cms/server - Versions diffs - 0.11.0 - Mend

@velora-cms/server 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (367) hide show

package/dist/docs-bundle/v1/using-velora/headless-api/index.html ADDED Viewed

@@ -0,0 +1,1620 @@
+<!DOCTYPE html><html lang="en" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-ewhz5xxr"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Headless API | Velora</title><link rel="shortcut icon" href="/docs/favicon.svg" type="image/svg+xml"/><meta name="generator" content="Astro v7.2.10"/><meta name="generator" content="Starlight v0.41.5"/><meta property="og:title" content="Headless API"/><meta property="og:type" content="article"/><meta property="og:locale" content="en"/><meta property="og:description" content="The complete /api/v1 reference — every route, parameter, response property, error body and limit, with live transcripts from the public demo."/><meta property="og:site_name" content="Velora"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="The complete /api/v1 reference — every route, parameter, response property, error body and limit, with live transcripts from the public demo."/><script>
+	window.StarlightThemeProvider = (() => {
+		const storedTheme =
+			typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
+		const theme =
+			storedTheme ||
+			(window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
+		document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
+		return {
+			updatePickers(theme = storedTheme || 'auto') {
+				document.querySelectorAll('starlight-theme-select').forEach((picker) => {
+					const select = picker.querySelector('select');
+					if (select) select.value = theme;
+					/** @type {HTMLTemplateElement | null} */
+					const tmpl = document.querySelector(`#theme-icons`);
+					const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
+					if (newIcon) {
+						const oldIcon = picker.querySelector('svg.label-icon');
+						if (oldIcon) {
+							oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
+						}
+					}
+				});
+			},
+		};
+	})();
+</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M5 12a1 1 0 0 0-1-1H3a1 1 0 0 0 0 2h1a1 1 0 0 0 1-1Zm.64 5-.71.71a1 1 0 0 0 0 1.41 1 1 0 0 0 1.41 0l.71-.71A1 1 0 0 0 5.64 17ZM12 5a1 1 0 0 0 1-1V3a1 1 0 0 0-2 0v1a1 1 0 0 0 1 1Zm5.66 2.34a1 1 0 0 0 .7-.29l.71-.71a1 1 0 1 0-1.41-1.41l-.66.71a1 1 0 0 0 0 1.41 1 1 0 0 0 .66.29Zm-12-.29a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.71-.71a1.004 1.004 0 1 0-1.43 1.41l.73.71ZM21 11h-1a1 1 0 0 0 0 2h1a1 1 0 0 0 0-2Zm-2.64 6A1 1 0 0 0 17 18.36l.71.71a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.76-.66ZM12 6.5a5.5 5.5 0 1 0 5.5 5.5A5.51 5.51 0 0 0 12 6.5Zm0 9a3.5 3.5 0 1 1 0-7 3.5 3.5 0 0 1 0 7Zm0 3.5a1 1 0 0 0-1 1v1a1 1 0 0 0 2 0v-1a1 1 0 0 0-1-1Z"/></svg><svg aria-hidden="true" class="dark astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.64 13a1 1 0 0 0-1.05-.14 8.049 8.049 0 0 1-3.37.73 8.15 8.15 0 0 1-8.14-8.1 8.59 8.59 0 0 1 .25-2A1 1 0 0 0 8 2.36a10.14 10.14 0 1 0 14 11.69 1 1 0 0 0-.36-1.05Zm-9.5 6.69A8.14 8.14 0 0 1 7.08 5.22v.27a10.15 10.15 0 0 0 10.14 10.14 9.784 9.784 0 0 0 2.1-.22 8.11 8.11 0 0 1-7.18 4.32v-.04Z"/></svg><svg aria-hidden="true" class="auto astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg></template><link rel="stylesheet" href="/docs/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/docs/_astro/common.DTXA7sXM.css"><script type="module" src="/docs/_astro/page.Dwipeu-R.js"></script></head><body class="astro-ewhz5xxr"><a class="sl-skip-link astro-zufphfvp" href="#_top">Skip to content</a><div class="page sl-flex astro-5auw3bkx"><header class="header astro-5auw3bkx"><div class="header astro-6ytusalw"><div class="title-wrapper sl-flex astro-6ytusalw"><a href="/docs/" class="site-title sl-flex astro-nu4hftpf"><span class="astro-nu4hftpf" translate="no">Velora</span></a></div><div class="sl-flex print:hidden astro-6ytusalw"><site-search class="astro-6ytusalw astro-zwj6qr56" data-translations="{&quot;placeholder&quot;:&quot;Search&quot;}"><button data-open-modal disabled aria-label="Search" aria-keyshortcuts="Control+K" class="astro-zwj6qr56"><svg aria-hidden="true" class="astro-zwj6qr56 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"/></svg><span class="sl-hidden md:sl-block astro-zwj6qr56" aria-hidden="true">Search</span><kbd class="sl-hidden md:sl-flex astro-zwj6qr56" style="display: none;"><kbd class="astro-zwj6qr56">Ctrl</kbd><kbd class="astro-zwj6qr56">K</kbd></kbd></button><dialog style="padding:0" aria-label="Search" class="astro-zwj6qr56"><div class="dialog-frame sl-flex astro-zwj6qr56"><button data-close-modal class="sl-flex md:sl-hidden astro-zwj6qr56">Cancel</button><div class="search-container astro-zwj6qr56"><div id="starlight__search" class="astro-zwj6qr56"></div></div></div></dialog></site-search><script>
+	(() => {
+		const openBtn = document.querySelector('button[data-open-modal]');
+		const shortcut = openBtn?.querySelector('kbd');
+		if (!openBtn || !(shortcut instanceof HTMLElement)) return;
+		const platformKey = shortcut.querySelector('kbd');
+		if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
+			platformKey.textContent = '⌘';
+			openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
+		}
+		shortcut.style.display = '';
+	})();
+</script><script type="module" src="/docs/_astro/Search.astro_astro_type_script_index_0_lang.CavldbAs.js"></script></div><div class="sl-hidden md:sl-flex print:hidden right-group astro-6ytusalw"><div class="sl-flex social-icons astro-6ytusalw"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-7uz3f5wr"><span class="sr-only astro-7uz3f5wr">Select theme</span><svg aria-hidden="true" class="icon label-icon astro-7uz3f5wr astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg><select autocomplete="off" class="astro-7uz3f5wr"><option value="dark" class="astro-7uz3f5wr">Dark</option><option value="light" class="astro-7uz3f5wr">Light</option><option value="auto" selected class="astro-7uz3f5wr">Auto</option></select><svg aria-hidden="true" class="icon caret astro-7uz3f5wr astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg></label></starlight-theme-select><script>
+	StarlightThemeProvider.updatePickers();
+</script><script type="module">var e=`starlight-theme`,t=e=>e===`auto`||e===`dark`||e===`light`?e:`auto`,n=()=>t(typeof localStorage<`u`&&localStorage.getItem(e));function r(t){typeof localStorage<`u`&&localStorage.setItem(e,t===`light`||t===`dark`?t:``)}var i=()=>matchMedia(`(prefers-color-scheme: light)`).matches?`light`:`dark`;function a(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e===`auto`?i():e,r(e)}matchMedia(`(prefers-color-scheme: light)`).addEventListener(`change`,()=>{n()===`auto`&&a(`auto`)});var o=class extends HTMLElement{constructor(){super(),a(n()),this.querySelector(`select`)?.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&a(t(e.currentTarget.value))})}};customElements.define(`starlight-theme-select`,o);</script><script type="module">var e=class extends HTMLElement{constructor(){super();let e=this.querySelector(`select`);e&&(e.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=e.currentTarget.value)}),window.addEventListener(`pageshow`,t=>{if(!t.persisted)return;let n=e.querySelector(`option[selected]`)?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}};customElements.define(`starlight-lang-select`,e);</script></div></div></header><nav class="sidebar print:hidden astro-5auw3bkx" aria-label="Main"><starlight-menu-button class="print:hidden astro-gnkm6dw5"><button aria-expanded="false" aria-label="Menu" aria-controls="starlight__sidebar" class="sl-flex md:sl-hidden astro-gnkm6dw5"><svg aria-hidden="true" class="open-menu astro-gnkm6dw5 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg><svg aria-hidden="true" class="close-menu astro-gnkm6dw5 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg></button></starlight-menu-button><script type="module">var e=class extends HTMLElement{btn=this.querySelector(`button`);constructor(){super(),this.btn.addEventListener(`click`,()=>this.toggleExpanded());let e=this.closest(`nav`);e&&e.addEventListener(`keyup`,e=>this.closeOnEscape(e)),matchMedia(`(min-width: 50em)`).addEventListener(`change`,()=>this.setExpanded(!1))}setExpanded(e){this.setAttribute(`aria-expanded`,String(e)),document.body.toggleAttribute(`data-mobile-menu-expanded`,e),document.querySelectorAll(`.main-frame, .sl-skip-link`).forEach(t=>{t.toggleAttribute(`inert`,e)})}toggleExpanded(){this.setExpanded(this.getAttribute(`aria-expanded`)!==`true`)}closeOnEscape(e){e.code===`Escape`&&(this.setExpanded(!1),this.btn.focus())}};customElements.define(`starlight-menu-button`,e);</script><div id="starlight__sidebar" class="sidebar-pane astro-5auw3bkx"><div class="sidebar-content sl-flex astro-5auw3bkx"><sl-sidebar-state-persist data-hash="03jp7ll" class="astro-pcs3l5kp"><script aria-hidden="true">
+		(() => {
+			try {
+				if (!matchMedia('(min-width: 50em)').matches) return;
+				/** @type {HTMLElement | null} */
+				const target = document.querySelector('sl-sidebar-state-persist');
+				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
+				if (!target || !state || target.dataset.hash !== state.hash) return;
+				window._starlightScrollRestore = state.scroll;
+				customElements.define(
+					'sl-sidebar-restore',
+					class SidebarRestore extends HTMLElement {
+						connectedCallback() {
+							try {
+								const idx = parseInt(this.dataset.index || '');
+								const details = this.closest('details');
+								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
+							} catch {}
+						}
+					}
+				);
+			} catch {}
+		})();
+	</script><ul class="top-level astro-ck7l566j"><li class="astro-ck7l566j"><details open class="astro-ck7l566j"><summary class="astro-ck7l566j"><span class="group-label astro-ck7l566j"><span class="large astro-ck7l566j">Using Velora</span></span><svg aria-hidden="true" class="caret astro-ck7l566j astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></summary><sl-sidebar-restore data-index="0"></sl-sidebar-restore><ul class="astro-ck7l566j"><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/" class="astro-ck7l566j"><span class="astro-ck7l566j">Using Velora</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/getting-started/" class="astro-ck7l566j"><span class="astro-ck7l566j">Getting started</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/installation/" class="astro-ck7l566j"><span class="astro-ck7l566j">Installation</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/content-model/" class="astro-ck7l566j"><span class="astro-ck7l566j">Document types</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/editing/" class="astro-ck7l566j"><span class="astro-ck7l566j">Content editing</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/media/" class="astro-ck7l566j"><span class="astro-ck7l566j">Media</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/users-and-roles/" class="astro-ck7l566j"><span class="astro-ck7l566j">Users and roles</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/installing-plugins/" class="astro-ck7l566j"><span class="astro-ck7l566j">Installing plugins</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/headless-api/" aria-current="page" class="astro-ck7l566j"><span class="astro-ck7l566j">Headless API</span></a></li><li class="astro-ck7l566j"><a href="/docs/v1/using-velora/build-a-headless-frontend/" class="astro-ck7l566j"><span class="astro-ck7l566j">Build a headless frontend</span></a></li></ul></details></li></ul><script aria-hidden="true">
+		(() => {
+			const scroller = document.getElementById('starlight__sidebar');
+			if (!window._starlightScrollRestore || !scroller) return;
+			scroller.scrollTop = window._starlightScrollRestore;
+			delete window._starlightScrollRestore;
+		})();
+	</script></sl-sidebar-state-persist><div class="md:sl-hidden"><div class="mobile-preferences sl-flex astro-yfet6llj"><div class="social-icons astro-yfet6llj"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-7uz3f5wr"><span class="sr-only astro-7uz3f5wr">Select theme</span><svg aria-hidden="true" class="icon label-icon astro-7uz3f5wr astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg><select autocomplete="off" class="astro-7uz3f5wr"><option value="dark" class="astro-7uz3f5wr">Dark</option><option value="light" class="astro-7uz3f5wr">Light</option><option value="auto" selected class="astro-7uz3f5wr">Auto</option></select><svg aria-hidden="true" class="icon caret astro-7uz3f5wr astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg></label></starlight-theme-select><script>
+	StarlightThemeProvider.updatePickers();
+</script></div></div></div></div></nav><div class="main-frame astro-5auw3bkx"><script type="module">var e=document.getElementById(`starlight__sidebar`),t=e?.querySelector(`sl-sidebar-state-persist`),n=`sl-sidebar-state`,r=()=>{let r=[],i=t?.dataset.hash||``;try{let e=sessionStorage.getItem(n),t=JSON.parse(e||`{}`);Array.isArray(t.open)&&t.hash===i&&(r=t.open)}catch{}return{hash:i,open:r,scroll:e?.scrollTop||0}},i=e=>{try{sessionStorage.setItem(n,JSON.stringify(e))}catch{}},a=()=>i(r()),o=(e,t)=>{let n=r();n.open[t]=e,i(n)};t?.addEventListener(`click`,e=>{if(!(e.target instanceof Element))return;let t=e.target.closest(`summary`)?.closest(`details`);if(!t)return;let n=t.querySelector(`sl-sidebar-restore`),r=parseInt(n?.dataset.index||``);isNaN(r)||o(!t.open,r)}),addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&a()});</script><div class="lg:sl-flex astro-perbdhd2"><aside class="right-sidebar-container print:hidden astro-perbdhd2"><div class="right-sidebar astro-perbdhd2"><div class="lg:sl-hidden astro-epm5tkrc"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-bnvebtr4"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-bnvebtr4"><details id="starlight__mobile-toc" class="astro-bnvebtr4"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-bnvebtr4"><span class="toggle sl-flex astro-bnvebtr4">On this page<svg aria-hidden="true" class="caret astro-bnvebtr4 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></span><span class="display-current astro-bnvebtr4"></span></summary><div class="dropdown astro-bnvebtr4"><ul class="isMobile astro-lptfoybu" style="--depth: 0;"><li style="--depth: 0;" class="astro-lptfoybu"><a href="#_top" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Overview</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#turn-it-on" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Turn it on</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#authentication" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Authentication</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#what-a-key-can-do" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">What a key can do</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#the-public-demo" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">The public demo</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#conventions" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Conventions</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#cursor-pagination" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Cursor pagination</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#published-only-reads" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Published-only reads</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#locale-and-fallback" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Locale and fallback</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#preview-tokens" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Preview tokens</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#content" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Content</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1content--search-and-filter" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content — search and filter</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentroots--top-level-nodes" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/roots — top-level nodes</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentidchildren--one-level-down" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/:id/children — one level down</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentid--one-item-with-its-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/:id — one item with its fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentby-path--resolve-a-url" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/by-path — resolve a URL</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#writing-content" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Writing content</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#post-apiv1content--create-a-node" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">POST /api/v1/content — create a node</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#put-apiv1contentid--replace-all-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">PUT /api/v1/content/:id — replace all fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#patch-apiv1contentid--change-some-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">PATCH /api/v1/content/:id — change some fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#post-apiv1contentidpublish--make-it-readable" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">POST /api/v1/content/:id/publish — make it readable</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#document-types" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Document types</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1document-types" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/document-types</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1document-typesid" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/document-types/:id</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#media" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Media</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1media" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/media</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1mediaid" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/media/:id</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#templates" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Templates</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1templates" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/templates</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#graphql" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">GraphQL</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#graphiql" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GraphiQL</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#openapi" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">OpenAPI</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#errors" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Errors</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#rate-limits" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Rate limits</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#next" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Next</span></a></li></ul></div></details></nav></mobile-starlight-toc><script type="module" src="/docs/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.BcSo_yiZ.js"></script></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-epm5tkrc"><div class="sl-container astro-epm5tkrc"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">On this page</h2><ul class="astro-lptfoybu" style="--depth: 0;"><li style="--depth: 0;" class="astro-lptfoybu"><a href="#_top" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Overview</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#turn-it-on" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Turn it on</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#authentication" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Authentication</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#what-a-key-can-do" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">What a key can do</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#the-public-demo" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">The public demo</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#conventions" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Conventions</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#cursor-pagination" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Cursor pagination</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#published-only-reads" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Published-only reads</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#locale-and-fallback" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Locale and fallback</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#preview-tokens" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Preview tokens</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#content" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Content</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1content--search-and-filter" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content — search and filter</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentroots--top-level-nodes" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/roots — top-level nodes</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentidchildren--one-level-down" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/:id/children — one level down</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentid--one-item-with-its-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/:id — one item with its fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1contentby-path--resolve-a-url" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/content/by-path — resolve a URL</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#writing-content" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Writing content</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#post-apiv1content--create-a-node" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">POST /api/v1/content — create a node</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#put-apiv1contentid--replace-all-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">PUT /api/v1/content/:id — replace all fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#patch-apiv1contentid--change-some-fields" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">PATCH /api/v1/content/:id — change some fields</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#post-apiv1contentidpublish--make-it-readable" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">POST /api/v1/content/:id/publish — make it readable</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#document-types" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Document types</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1document-types" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/document-types</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1document-typesid" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/document-types/:id</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#media" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Media</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1media" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/media</span></a></li><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1mediaid" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/media/:id</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#templates" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Templates</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#get-apiv1templates" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GET /api/v1/templates</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#graphql" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">GraphQL</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#graphiql" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">GraphiQL</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#openapi" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">OpenAPI</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#errors" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Errors</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#rate-limits" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Rate limits</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#next" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Next</span></a></li></ul></nav></starlight-toc><script type="module" src="/docs/_astro/TableOfContents.astro_astro_type_script_index_0_lang.Csloo1VZ.js"></script></div></div></div></aside><div class="main-pane astro-perbdhd2"><main data-pagefind-body class="astro-ewhz5xxr" lang="en" dir="ltr"><div class="content-panel astro-ahkzlqop"><div class="sl-container astro-ahkzlqop"><h1 id="_top" class="astro-oef2efwn">Headless API</h1></div></div><div class="content-panel astro-ahkzlqop"><div class="sl-container astro-ahkzlqop"><div class="sl-markdown-content"><p><code dir="auto">/api/v1</code> is Velora’s public content API: the surface your own frontend
+reads from, and — with a key minted for writing — writes to. It is a
+deploy-time opt-in. When it is off, none of the routes below exist at all
+(a <code dir="auto">404</code>, not a <code dir="auto">403</code>), which is what lets one codebase run as a closed
+back office or as a headless content service depending on how it is
+deployed.</p>
+<p>This page is the complete reference. Everything on it was read out of the
+route definitions in <code dir="auto">apps/server/src/routes/public-api.ts</code> and the Zod
+schemas in <code dir="auto">packages/api-schemas</code>; the JSON blocks marked <strong>live</strong> are
+verbatim responses from the public demo at <code dir="auto">https://demo.velora-cms.com</code>,
+and the rest are shapes derived from those schemas, where ids, timestamps
+and field names are illustrative.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="turn-it-on">Turn it on</h2><a class="sl-anchor-link" href="#turn-it-on"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Turn it on”</span></a></div>
+<p>The public API is registered at boot when <code dir="auto">VELORA_HEADLESS</code> is <code dir="auto">true</code> or
+<code dir="auto">1</code>. Anything else — including unset — leaves the namespace unregistered.
+There is no runtime toggle in the admin, deliberately: this is a property
+of the deployment, like the database dialect.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">VELORA_HEADLESS</code></td><td><code dir="auto">"true"</code> or <code dir="auto">"1"</code> to enable</td><td>Registers the whole <code dir="auto">/api/v1</code> namespace, GraphQL included. Unset or any other value = the routes do not exist. No default (off).</td><td><code dir="auto">true</code></td></tr><tr><td><code dir="auto">VELORA_PUBLIC_DOCS</code></td><td>boolean-ish string</td><td>Serves the public OpenAPI UI at <code dir="auto">/api/v1/docs</code> and the GraphiQL page at <code dir="auto">/api/v1/graphiql</code>, and allows GraphQL introspection. <strong>On by default</strong> — only <code dir="auto">false</code> or <code dir="auto">0</code> turns it off, which <code dir="auto">404</code>s the docs without touching the API.</td><td><code dir="auto">false</code></td></tr><tr><td><code dir="auto">VELORA_GRAPHQL_MAX_DEPTH</code></td><td>positive integer</td><td>Maximum nesting depth of a GraphQL query. Default <code dir="auto">8</code>. Non-integer, zero and negative values fall back to the default.</td><td><code dir="auto">8</code></td></tr><tr><td><code dir="auto">VELORA_GRAPHQL_MAX_COMPLEXITY</code></td><td>positive integer</td><td>Maximum number of field selections a GraphQL operation may reach, fragments expanded per spread site. Default <code dir="auto">500</code>.</td><td><code dir="auto">500</code></td></tr><tr><td><code dir="auto">VELORA_RATE_LIMIT_MAX</code></td><td>positive integer</td><td>Requests allowed per window for a caller presenting a real, unrevoked API key. Default <code dir="auto">100</code>.</td><td><code dir="auto">100</code></td></tr><tr><td><code dir="auto">VELORA_RATE_LIMIT_IP_MAX</code></td><td>positive integer</td><td>Requests allowed per window for an anonymous caller — no key, or a key that does not resolve. Default <code dir="auto">60</code>.</td><td><code dir="auto">60</code></td></tr><tr><td><code dir="auto">VELORA_RATE_LIMIT_WINDOW</code></td><td>duration string</td><td>The window both ceilings are measured over. Default <code dir="auto">1 minute</code>. An unparseable value falls back to the default rather than breaking the routes.</td><td><code dir="auto">1 minute</code></td></tr><tr><td><code dir="auto">VELORA_PREVIEW_TOKEN_TTL</code></td><td>positive integer (seconds)</td><td>Lifetime of a preview token minted for a draft read. Default <code dir="auto">1800</code> (30 minutes).</td><td><code dir="auto">900</code></td></tr><tr><td><code dir="auto">JWT_SECRET</code></td><td>string</td><td>Already required for admin sessions; a separate key is derived from it to sign preview tokens. Rotating it invalidates outstanding preview tokens.</td><td><code dir="auto">a-long-random-string</code></td></tr></tbody></table>
+<p>A minimal headless deployment sets one variable beyond the usual core
+configuration. Run this from the repository root:</p>
+<div class="expressive-code"><link rel="stylesheet" href="/docs/_astro/ec.w36nc.css"><script type="module" src="/docs/_astro/ec.0vx5m.js"></script><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#C5E478;--1:#3B61B0">VELORA_HEADLESS</span><span style="--0:#C792EA;--1:#8844AE">=</span><span style="--0:#ECC48D;--1:#3B61B0">true</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">node</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">apps/server/dist/index.js</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="VELORA_HEADLESS=true node apps/server/dist/index.js"><div></div></button></div></figure></div>
+<p>The server boots as normal and the <code dir="auto">/api/v1</code> routes start answering; with
+the variable removed, the same requests return Velora’s ordinary 404 body
+instead.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="authentication">Authentication</h2><a class="sl-anchor-link" href="#authentication"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Authentication”</span></a></div>
+<p>Every <code dir="auto">/api/v1</code> route requires an API key as a bearer token. Keys are
+minted in the admin under <strong>Settings → API Keys</strong> — see <a href="/docs/v1/using-velora/users-and-roles/">Users and
+roles</a> for creating, listing and
+revoking them. An admin session token is <em>not</em> accepted here, and an API
+key is not accepted on the admin <code dir="auto">/api/*</code> routes; the two are separate
+credentials on separate code paths.</p>
+<p>Call it with no key at all:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content?limit=1</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s &#x22;https://demo.velora-cms.com/api/v1/content?limit=1&#x22;"><div></div></button></div></figure></div>
+<p>With no <code dir="auto">Authorization</code> header, that is a <code dir="auto">401</code> — <strong>live</strong>, and identical
+for every failure mode (missing header, wrong prefix, unknown key, revoked
+key), so a caller cannot probe which keys exist:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"message"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">A valid API key is required</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;message&#x22;:&#x22;A valid API key is required&#x22;}"><div></div></button></div></figure></div>
+<p>Sending the key is one header:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content?limit=1</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content?limit=1&#x22;"><div></div></button></div></figure></div>
+<p>That returns the list envelope described under <a href="#cursor-pagination">Cursor
+pagination</a> below.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="what-a-key-can-do">What a key can do</h3><a class="sl-anchor-link" href="#what-a-key-can-do"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “What a key can do”</span></a></div>
+<p>Every key carries a scope, fixed when it was minted, and <strong>the default is
+read</strong>. A key created without asking for anything else reaches the read
+routes and nothing more.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">read</code></td><td>scope</td><td>The default. Reaches every <code dir="auto">GET</code> on this page — content, document types, media, templates — and the GraphQL endpoint. Refused on all four write routes.</td><td>A key for a public website</td></tr><tr><td><code dir="auto">write</code></td><td>scope</td><td>Implies read, and additionally passes <code dir="auto">POST /api/v1/content</code>, <code dir="auto">PUT</code>/<code dir="auto">PATCH /api/v1/content/:id</code> and <code dir="auto">POST /api/v1/content/:id/publish</code>.</td><td>A key for a migration script</td></tr></tbody></table>
+<p>Write access is therefore a per-key choice an administrator makes on
+purpose — see <a href="/docs/v1/using-velora/users-and-roles/#create-a-key">Users and
+roles</a> for the create call
+and the admin form. The read routes are gated by <code dir="auto">requireApiKey</code> alone; the
+four write routes run a second check on the authenticated key’s scope, and
+a read key gets a <code dir="auto">403</code> with exactly this body:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"message"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">This API key is read-only</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;message&#x22;:&#x22;This API key is read-only&#x22;}"><div></div></button></div></figure></div>
+<p>That is a different failure from the <code dir="auto">401</code> above: the key is real and
+unrevoked, it simply may not write.</p>
+<p>So: <strong>treat a write key as a password</strong>. Blocking non-<code dir="auto">GET</code> methods at your
+reverse proxy is still worth doing as a second layer — it is how the public
+demo below is set up — but with scopes it is defense in depth rather than
+the only thing holding the door.</p>
+<p>Writes are attributed to a fixed system account, <code dir="auto">api-author@velora.internal</code>
+(“Public API”, role <code dir="auto">editor</code>), created idempotently at boot. It is a
+non-login account: its password hash is random bytes nobody holds the
+plaintext for, so it can never sign in. Every version a key writes carries
+that account as its author, which is why API writes are distinguishable
+from a person’s edits in version history but not from each other.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="the-public-demo">The public demo</h3><a class="sl-anchor-link" href="#the-public-demo"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “The public demo”</span></a></div>
+<p>The demo instance used for the live transcripts on this page publishes its
+key on purpose:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>Demo origin</td><td>string (URL)</td><td>A live, seeded Velora instance.</td><td><code dir="auto">https://demo.velora-cms.com</code></td></tr><tr><td>Demo key</td><td>string</td><td>Intentionally public, rate-limited, rotated at will.</td><td><code dir="auto">vk_4ac0a6b78b953a13b8646e6379fcbb6bee1a269af253a14eebce668572019328</code></td></tr></tbody></table>
+<p>The demo blocks every non-<code dir="auto">GET</code> method on <code dir="auto">/api/v1/</code> at its edge, with one
+exception: <code dir="auto">POST /api/v1/graphql</code> is let through, because the GraphQL
+schema declares no <code dir="auto">Mutation</code> type and GraphiQL posts its queries, so
+there is nothing to write there. Every other non-<code dir="auto">GET</code> request — the REST
+write routes below included — meets a <code dir="auto">403 Forbidden</code> in HTML before it
+reaches Velora. That is a property of <em>that deployment’s proxy</em>, layered on
+top of the key’s own scope rather than in place of it — the JSON <code dir="auto">403</code> from
+the section above never gets a chance to be produced here:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-si</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-X</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">POST</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Content-Type: application/json</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-d</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">{"documentTypeId":"…","parentId":null,"slug":"probe"}</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -si -X POST &#x22;https://demo.velora-cms.com/api/v1/content&#x22; \  -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  -H &#x22;Content-Type: application/json&#x22; \  -d &#x27;{&#x22;documentTypeId&#x22;:&#x22;…&#x22;,&#x22;parentId&#x22;:null,&#x22;slug&#x22;:&#x22;probe&#x22;}&#x27;"><div></div></button></div></figure></div>
+<p>The response never comes from Velora at all — <strong>live</strong>, note the <code dir="auto">Server</code>
+header and the HTML content type:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="plaintext"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">HTTP/1.1 403 Forbidden</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Server: nginx/1.24.0 (Ubuntu)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">Content-Type: text/html</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="HTTP/1.1 403 ForbiddenServer: nginx/1.24.0 (Ubuntu)Content-Type: text/html"><div></div></button></div></figure></div>
+<p>Write examples further down this page are therefore schema-derived, shown
+against a local instance.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="conventions">Conventions</h2><a class="sl-anchor-link" href="#conventions"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Conventions”</span></a></div>
+<p>Four things behave identically across the whole surface, so they are
+described once here rather than repeated per route.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="cursor-pagination">Cursor pagination</h3><a class="sl-anchor-link" href="#cursor-pagination"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Cursor pagination”</span></a></div>
+<p>Every list route answers the same envelope: an <code dir="auto">items</code> array and a
+<code dir="auto">nextCursor</code>. There is no offset, no total count, and no unbounded list.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size. Default <code dir="auto">50</code> on every list except media, which defaults to <code dir="auto">24</code>. Out of range is a <code dir="auto">400</code>, never a silent clamp.</td><td><code dir="auto">2</code></td></tr><tr><td><code dir="auto">cursor</code></td><td>string (uuid)</td><td>The <code dir="auto">id</code> of the last item on the previous page. Omit it for the first page.</td><td><code dir="auto">45dfb6ca-ffa7-482e-842b-f662c0c1034c</code></td></tr><tr><td><code dir="auto">items</code></td><td>array</td><td>The page of rows, in tree order for content lists.</td><td><code dir="auto">[…]</code></td></tr><tr><td><code dir="auto">nextCursor</code></td><td>string (uuid) or null</td><td>The id to pass as <code dir="auto">cursor</code> for the next page. It is non-null exactly when the page came back full (<code dir="auto">items.length === limit</code>), so the last page of a perfectly-divisible list still hands you a cursor — the following request then returns an empty <code dir="auto">items</code> and <code dir="auto">null</code>.</td><td><code dir="auto">45dfb6ca-…</code></td></tr></tbody></table>
+<p>Here are two consecutive pages of one node’s children on the demo, one
+item at a time — first page, no cursor:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af/children?limit=1</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af/children?limit=1&#x22;"><div></div></button></div></figure></div>
+<p>One row comes back, and <code dir="auto">nextCursor</code> repeats its id — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">afe5b000-d81e-4c51-b60a-1f5f04d6dacf</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/jane-doe/hello-velora</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">f0491ccf-0511-43a7-862b-fdf9dce55f3c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T15:36:10.252Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">afe5b000-d81e-4c51-b60a-1f5f04d6dacf</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;afe5b000-d81e-4c51-b60a-1f5f04d6dacf&#x22;,&#x22;parentId&#x22;:&#x22;acc3aefb-6254-465a-b088-c9578b2794af&#x22;,&#x22;path&#x22;:&#x22;/jane-doe/hello-velora&#x22;,&#x22;depth&#x22;:1,&#x22;sortOrder&#x22;:0,&#x22;documentTypeId&#x22;:&#x22;f0491ccf-0511-43a7-862b-fdf9dce55f3c&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T15:36:10.252Z&#x22;}],&#x22;nextCursor&#x22;:&#x22;afe5b000-d81e-4c51-b60a-1f5f04d6dacf&#x22;}"><div></div></button></div></figure></div>
+<p>Feeding that value back as <code dir="auto">cursor</code> asks for the page after it:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af/children?limit=1&#x26;cursor=afe5b000-d81e-4c51-b60a-1f5f04d6dacf</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af/children?limit=1&#x26;cursor=afe5b000-d81e-4c51-b60a-1f5f04d6dacf&#x22;"><div></div></button></div></figure></div>
+<p>The second child arrives — <strong>live</strong>. Stop when <code dir="auto">nextCursor</code> is <code dir="auto">null</code>, or
+when a page comes back empty:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">ce16029a-f5ef-4bbe-ad07-6eede30c9b8c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/jane-doe/writing-your-first-post</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">f0491ccf-0511-43a7-862b-fdf9dce55f3c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.741Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">ce16029a-f5ef-4bbe-ad07-6eede30c9b8c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;ce16029a-f5ef-4bbe-ad07-6eede30c9b8c&#x22;,&#x22;parentId&#x22;:&#x22;acc3aefb-6254-465a-b088-c9578b2794af&#x22;,&#x22;path&#x22;:&#x22;/jane-doe/writing-your-first-post&#x22;,&#x22;depth&#x22;:1,&#x22;sortOrder&#x22;:1,&#x22;documentTypeId&#x22;:&#x22;f0491ccf-0511-43a7-862b-fdf9dce55f3c&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.741Z&#x22;}],&#x22;nextCursor&#x22;:&#x22;ce16029a-f5ef-4bbe-ad07-6eede30c9b8c&#x22;}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="published-only-reads">Published-only reads</h3><a class="sl-anchor-link" href="#published-only-reads"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Published-only reads”</span></a></div>
+<p>Every read route serves published content only, and every miss — unknown
+id, unknown path, a draft, an unpublished translation — answers the same
+<code dir="auto">404</code> body, <code dir="auto">{"message":"No published content found"}</code>. The uniformity is
+the point: a key holder cannot use the read surface to discover which
+drafts exist. The write routes are the deliberate exception; they address
+a node by id in any publish state, because a key holder there is a writer
+editing their own draft.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="locale-and-fallback">Locale and fallback</h3><a class="sl-anchor-link" href="#locale-and-fallback"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Locale and fallback”</span></a></div>
+<p>Item reads (<code dir="auto">/api/v1/content/:id</code> and <code dir="auto">/api/v1/content/by-path</code>) accept a
+locale pair, resolved the same way as the admin API.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters</td><td>The translation to resolve to, starting from the node you addressed.</td><td><code dir="auto">ar</code></td></tr><tr><td><code dir="auto">fallback</code></td><td>string, at least 2 characters</td><td>The locale to fall back to when the requested one is missing. A <strong>locale string</strong>, not a boolean.</td><td><code dir="auto">en</code></td></tr></tbody></table>
+<p>Both the node you named and the translation resolved from it must be
+published, or the read is the uniform <code dir="auto">404</code>.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="preview-tokens">Preview tokens</h3><a class="sl-anchor-link" href="#preview-tokens"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Preview tokens”</span></a></div>
+<p>A draft can be read through the public API only with a preview token. An
+admin session mints one per content id with <code dir="auto">POST /api/content/:id/preview-token</code>
+(an admin route, session-gated), and the public read routes accept it as a
+query parameter.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">previewToken</code></td><td>string</td><td><code dir="auto">base64url(payload).base64url(signature)</code> — exactly one dot, so it can never be confused with an admin session token. Signed with a key derived from <code dir="auto">JWT_SECRET</code>; expires after <code dir="auto">VELORA_PREVIEW_TOKEN_TTL</code> seconds.</td><td><code dir="auto">eyJjb250ZW50….Xq7…</code></td></tr></tbody></table>
+<p>A token unlocks exactly the one node id it names, and it is checked
+against the node <em>after</em> locale resolution — a token for a different node,
+a tampered token, an expired token and no token at all are all treated the
+same way (no unlock, uniform <code dir="auto">404</code>). A draft served this way is the only
+case where <code dir="auto">publishedAt</code> comes back <code dir="auto">null</code> on a read.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="content">Content</h2><a class="sl-anchor-link" href="#content"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Content”</span></a></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1content--search-and-filter"><code dir="auto">GET /api/v1/content</code> — search and filter</h3><a class="sl-anchor-link" href="#get-apiv1content--search-and-filter"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/content — search and filter”</span></a></div>
+<p>Combinable filters over every published node in the site.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid), optional</td><td>Only nodes of this document type.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr><tr><td><code dir="auto">under</code></td><td>string (uuid), optional</td><td>Only strict descendants of this published node, resolved server-side to a materialised-path prefix. An unknown or unpublished anchor is a <code dir="auto">404</code>.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">q</code></td><td>string, at least 2 characters, optional</td><td>Case-insensitive substring match. The two-character floor keeps a single character from triggering a full scan.</td><td><code dir="auto">hello</code></td></tr><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>Pagination cursor.</td><td><code dir="auto">45dfb6ca-…</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size, default <code dir="auto">50</code>.</td><td><code dir="auto">2</code></td></tr></tbody></table>
+<p>Two published nodes, page size two:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content?limit=2</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content?limit=2&#x22;"><div></div></button></div></figure></div>
+<p>The response is a page of <strong>summaries</strong> — <strong>live</strong>. Note there is no
+<code dir="auto">data</code>: a list never carries field values, so rendering an item always
+takes a second request:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2e9053b1-a300-493f-a48b-58440cdf3629</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.729Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">45dfb6ca-ffa7-482e-842b-f662c0c1034c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/guides</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">2</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.733Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">45dfb6ca-ffa7-482e-842b-f662c0c1034c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;2e9053b1-a300-493f-a48b-58440cdf3629&#x22;,&#x22;parentId&#x22;:null,&#x22;path&#x22;:&#x22;/announcements&#x22;,&#x22;depth&#x22;:0,&#x22;sortOrder&#x22;:1,&#x22;documentTypeId&#x22;:&#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.729Z&#x22;},{&#x22;id&#x22;:&#x22;45dfb6ca-ffa7-482e-842b-f662c0c1034c&#x22;,&#x22;parentId&#x22;:null,&#x22;path&#x22;:&#x22;/guides&#x22;,&#x22;depth&#x22;:0,&#x22;sortOrder&#x22;:2,&#x22;documentTypeId&#x22;:&#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.733Z&#x22;}],&#x22;nextCursor&#x22;:&#x22;45dfb6ca-ffa7-482e-842b-f662c0c1034c&#x22;}"><div></div></button></div></figure></div>
+<p>Every property of a summary row:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The node’s identity, and the <code dir="auto">:id</code> in every other content route.</td><td><code dir="auto">2e9053b1-a300-493f-a48b-58440cdf3629</code></td></tr><tr><td><code dir="auto">parentId</code></td><td>string (uuid) or null</td><td>The parent node, or <code dir="auto">null</code> for a root.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">path</code></td><td>string</td><td>The materialised path — the node’s position in the tree, and what <code dir="auto">by-path</code> resolves.</td><td><code dir="auto">/jane-doe/hello-velora</code></td></tr><tr><td><code dir="auto">depth</code></td><td>integer, 0 or more</td><td>Number of ancestors. A root is <code dir="auto">0</code>.</td><td><code dir="auto">1</code></td></tr><tr><td><code dir="auto">sortOrder</code></td><td>integer</td><td>Position among siblings, ascending.</td><td><code dir="auto">0</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid)</td><td>Which document type this node is; look it up to interpret the item’s <code dir="auto">data</code>.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string</td><td>The translation this row is.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">publishedAt</code></td><td>ISO datetime string</td><td>When this node was published. Never null on a list — lists are published-only by construction.</td><td><code dir="auto">2026-08-25T14:31:45.729Z</code></td></tr></tbody></table>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1contentroots--top-level-nodes"><code dir="auto">GET /api/v1/content/roots</code> — top-level nodes</h3><a class="sl-anchor-link" href="#get-apiv1contentroots--top-level-nodes"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/content/roots — top-level nodes”</span></a></div>
+<p>The published nodes with no parent, in sort order. Takes <code dir="auto">cursor</code> and
+<code dir="auto">limit</code> only — the shared <a href="#cursor-pagination">pagination parameters</a>
+above — and answers the same envelope as <code dir="auto">/api/v1/content</code>.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>See <a href="#cursor-pagination">Cursor pagination</a>.</td><td><code dir="auto">45dfb6ca-ffa7-482e-842b-f662c0c1034c</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>See <a href="#cursor-pagination">Cursor pagination</a>. Default <code dir="auto">50</code>.</td><td><code dir="auto">3</code></td></tr></tbody></table>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/roots?limit=3</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/roots?limit=3&#x22;"><div></div></button></div></figure></div>
+<p>Three roots come back — <strong>live</strong> — and this is the natural entry point for
+building a navigation tree:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/jane-doe</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">511011a7-2a0b-42be-95c1-f6831d7dcbe6</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.725Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2e9053b1-a300-493f-a48b-58440cdf3629</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.729Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">45dfb6ca-ffa7-482e-842b-f662c0c1034c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/guides</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"sortOrder"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">2</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.733Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">45dfb6ca-ffa7-482e-842b-f662c0c1034c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;acc3aefb-6254-465a-b088-c9578b2794af&#x22;,&#x22;parentId&#x22;:null,&#x22;path&#x22;:&#x22;/jane-doe&#x22;,&#x22;depth&#x22;:0,&#x22;sortOrder&#x22;:0,&#x22;documentTypeId&#x22;:&#x22;511011a7-2a0b-42be-95c1-f6831d7dcbe6&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.725Z&#x22;},{&#x22;id&#x22;:&#x22;2e9053b1-a300-493f-a48b-58440cdf3629&#x22;,&#x22;parentId&#x22;:null,&#x22;path&#x22;:&#x22;/announcements&#x22;,&#x22;depth&#x22;:0,&#x22;sortOrder&#x22;:1,&#x22;documentTypeId&#x22;:&#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.729Z&#x22;},{&#x22;id&#x22;:&#x22;45dfb6ca-ffa7-482e-842b-f662c0c1034c&#x22;,&#x22;parentId&#x22;:null,&#x22;path&#x22;:&#x22;/guides&#x22;,&#x22;depth&#x22;:0,&#x22;sortOrder&#x22;:2,&#x22;documentTypeId&#x22;:&#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.733Z&#x22;}],&#x22;nextCursor&#x22;:&#x22;45dfb6ca-ffa7-482e-842b-f662c0c1034c&#x22;}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1contentidchildren--one-level-down"><code dir="auto">GET /api/v1/content/:id/children</code> — one level down</h3><a class="sl-anchor-link" href="#get-apiv1contentidchildren--one-level-down"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/content/:id/children — one level down”</span></a></div>
+<p>Direct children of a published node, paginated. The parent itself must be
+published, or the answer is the uniform <code dir="auto">404</code> — an unpublished branch
+hides its whole subtree from this route.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The parent node. A non-uuid value fails validation with a <code dir="auto">400</code>.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>Pagination cursor.</td><td><code dir="auto">afe5b000-…</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size, default <code dir="auto">50</code>.</td><td><code dir="auto">1</code></td></tr></tbody></table>
+<p>The two-page example under <a href="#cursor-pagination">Cursor pagination</a> uses
+this route; the envelope and row shape are identical to <code dir="auto">/api/v1/content</code>.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1contentid--one-item-with-its-fields"><code dir="auto">GET /api/v1/content/:id</code> — one item with its fields</h3><a class="sl-anchor-link" href="#get-apiv1contentid--one-item-with-its-fields"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/content/:id — one item with its fields”</span></a></div>
+<p>The full item: core identity plus the published version’s field data.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The node to read.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters, optional</td><td>Resolve to this translation.</td><td><code dir="auto">ar</code></td></tr><tr><td><code dir="auto">fallback</code></td><td>string, at least 2 characters, optional</td><td>Locale to fall back to.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">format</code></td><td>string <code dir="auto">&#x3C;pluginId>:&#x3C;name></code>, optional</td><td>Replace the whole response with a plugin-owned projection. Must match <code dir="auto">^[a-z0-9.-]+:[a-z0-9-]+$</code>.</td><td><code dir="auto">com.example.seo:sitemap</code></td></tr><tr><td><code dir="auto">previewToken</code></td><td>string, optional</td><td>Unlock this one node’s draft.</td><td><code dir="auto">eyJjb250ZW50….Xq7…</code></td></tr></tbody></table>
+<p>Reading the demo’s Author node:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/acc3aefb-6254-465a-b088-c9578b2794af&#x22;"><div></div></button></div></figure></div>
+<p>The item arrives with its fields under <code dir="auto">data</code> — <strong>live</strong>. <code dir="auto">bio</code> is a rich
+text field, so its value is a document object, not an HTML string:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">511011a7-2a0b-42be-95c1-f6831d7dcbe6</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.725Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"bio"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">doc</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"content"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">paragraph</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"content"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"text"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Founding editor of this blog.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">text</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}]}]},</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Jane Doe</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;id&#x22;:&#x22;acc3aefb-6254-465a-b088-c9578b2794af&#x22;,&#x22;documentTypeId&#x22;:&#x22;511011a7-2a0b-42be-95c1-f6831d7dcbe6&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.725Z&#x22;,&#x22;version&#x22;:1,&#x22;data&#x22;:{&#x22;bio&#x22;:{&#x22;type&#x22;:&#x22;doc&#x22;,&#x22;content&#x22;:[{&#x22;type&#x22;:&#x22;paragraph&#x22;,&#x22;content&#x22;:[{&#x22;text&#x22;:&#x22;Founding editor of this blog.&#x22;,&#x22;type&#x22;:&#x22;text&#x22;}]}]},&#x22;name&#x22;:&#x22;Jane Doe&#x22;}}"><div></div></button></div></figure></div>
+<p>Every property of an item:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The node’s identity.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid)</td><td>The document type whose fields describe <code dir="auto">data</code>.</td><td><code dir="auto">511011a7-2a0b-42be-95c1-f6831d7dcbe6</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters</td><td>The translation actually served, after locale/fallback resolution.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">publishedAt</code></td><td>ISO datetime string or null</td><td>When this node was published. <code dir="auto">null</code> only for a draft served through a valid <code dir="auto">previewToken</code>.</td><td><code dir="auto">2026-08-25T14:31:45.725Z</code></td></tr><tr><td><code dir="auto">version</code></td><td>positive integer</td><td>Which immutable version this is. Every save mints a new one; publishing repoints at one.</td><td><code dir="auto">3</code></td></tr><tr><td><code dir="auto">data</code></td><td>object</td><td>Field values keyed by field <strong>id</strong>, exactly as the document type defines them. Values are whatever the field’s data type stores — a string, a number, an ISO date string, or a nested object for rich text and structured fields.</td><td><code dir="auto">{"name":"Jane Doe"}</code></td></tr><tr><td><code dir="auto">extensions</code></td><td>object, absent when unused</td><td>Present only when an active plugin contributed to this response. Keyed by plugin id, one nested object per plugin, structurally separate from <code dir="auto">data</code> so a plugin can never overwrite a field.</td><td><code dir="auto">{"com.example.seo":{"canonical":"/jane-doe"}}</code></td></tr></tbody></table>
+<p>Asking for a <code dir="auto">format</code> no active plugin provides is a <code dir="auto">400</code>, never a silent
+fallback to the default shape:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/2e9053b1-a300-493f-a48b-58440cdf3629?format=nope:thing</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/2e9053b1-a300-493f-a48b-58440cdf3629?format=nope:thing&#x22;"><div></div></button></div></figure></div>
+<p>The message names the projection you asked for — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"message"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Unknown format nope:thing</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;message&#x22;:&#x22;Unknown format nope:thing&#x22;}"><div></div></button></div></figure></div>
+<p>A successful <code dir="auto">format</code> read replaces the whole body with two properties
+instead — <code dir="auto">{"format": "&#x3C;pluginId>:&#x3C;name>", "content": …}</code>, where <code dir="auto">content</code>
+is whatever the plugin built. Contributing one is a plugin-authoring
+topic; see
+<a href="https://docs.velora-cms.com/v1/building-plugins/">Building plugins</a>.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1contentby-path--resolve-a-url"><code dir="auto">GET /api/v1/content/by-path</code> — resolve a URL</h3><a class="sl-anchor-link" href="#get-apiv1contentby-path--resolve-a-url"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/content/by-path — resolve a URL”</span></a></div>
+<p>The same item shape as <code dir="auto">/api/v1/content/:id</code>, addressed by tree path
+rather than id. This is how a frontend turns a request URL into content
+without storing ids anywhere.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">path</code></td><td>string starting with <code dir="auto">/</code>, required</td><td>The node’s materialised path. URL-encode it in the query string.</td><td><code dir="auto">/announcements</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters, optional</td><td>Resolve to this translation.</td><td><code dir="auto">ar</code></td></tr><tr><td><code dir="auto">fallback</code></td><td>string, at least 2 characters, optional</td><td>Locale to fall back to.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">format</code></td><td>string <code dir="auto">&#x3C;pluginId>:&#x3C;name></code>, optional</td><td>Plugin-owned projection, as above.</td><td><code dir="auto">com.example.seo:sitemap</code></td></tr><tr><td><code dir="auto">previewToken</code></td><td>string, optional</td><td>Unlock this one node’s draft. With a valid token the path lookup itself may resolve an unpublished node.</td><td><code dir="auto">eyJjb250ZW50….Xq7…</code></td></tr></tbody></table>
+<p>Resolving <code dir="auto">/announcements</code> on the demo:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content/by-path?path=/announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content/by-path?path=/announcements&#x22;"><div></div></button></div></figure></div>
+<p>The item comes back in the identical shape a by-id read returns — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2e9053b1-a300-493f-a48b-58440cdf3629</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T14:31:45.729Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"label"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Site news.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;id&#x22;:&#x22;2e9053b1-a300-493f-a48b-58440cdf3629&#x22;,&#x22;documentTypeId&#x22;:&#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;publishedAt&#x22;:&#x22;2026-08-25T14:31:45.729Z&#x22;,&#x22;version&#x22;:1,&#x22;data&#x22;:{&#x22;label&#x22;:&#x22;Announcements&#x22;,&#x22;description&#x22;:&#x22;Site news.&#x22;}}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h2"><h2 id="writing-content">Writing content</h2><a class="sl-anchor-link" href="#writing-content"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Writing content”</span></a></div>
+<p>Four routes write. They run the <code dir="auto">requireApiKey</code> gate the reads run and then
+a second check that the authenticated key’s scope is <code dir="auto">write</code> — a read key
+stops there with <code dir="auto">403 {"message":"This API key is read-only"}</code>. They address
+a node in <strong>any</strong> publish state, and never mutate a row: every save inserts
+a new immutable version, and publishing only repoints which version is
+current.</p>
+<p>The demo blocks these methods at its edge, so the transcripts in this
+section are schema-derived against a local instance — ids and timestamps
+are illustrative.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="post-apiv1content--create-a-node"><code dir="auto">POST /api/v1/content</code> — create a node</h3><a class="sl-anchor-link" href="#post-apiv1content--create-a-node"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “POST /api/v1/content — create a node”</span></a></div>
+<p>The server derives <code dir="auto">path</code> and <code dir="auto">depth</code> from <code dir="auto">parentId</code> plus <code dir="auto">slug</code>, so an
+external consumer never computes those tree internals. <code dir="auto">sortOrder</code> is
+<em>not</em> derived — every node created through this route is hardcoded to
+<code dir="auto">sortOrder: 0</code>, so siblings created via the public API all land at
+position <code dir="auto">0</code> and need reordering afterward if their relative order
+matters.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid), required</td><td>The type of node to create. Unknown = <code dir="auto">400</code>.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr><tr><td><code dir="auto">parentId</code></td><td>string (uuid) or null, required</td><td>Parent node, or <code dir="auto">null</code> for a root. A parent id that does not exist is a <code dir="auto">404</code>.</td><td><code dir="auto">acc3aefb-6254-465a-b088-c9578b2794af</code></td></tr><tr><td><code dir="auto">slug</code></td><td>string, required</td><td>One already-slugified path segment, matching <code dir="auto">^[a-z0-9]+(?:-[a-z0-9]+)*$</code>. Appended to the parent’s path.</td><td><code dir="auto">hello-world</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters</td><td>Which translation this node is. Default <code dir="auto">"en"</code>.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">isDefaultLocale</code></td><td>boolean</td><td>Whether this is the translation group’s default. Default <code dir="auto">true</code>.</td><td><code dir="auto">true</code></td></tr><tr><td><code dir="auto">translationGroupId</code></td><td>string (uuid), optional</td><td>Join an existing translation group instead of starting one.</td><td><code dir="auto">7f3c1a90-4b28-4d6e-9c15-0a3e8b7d2f64</code></td></tr><tr><td><code dir="auto">data</code></td><td>object</td><td>Field values keyed by field id. Default <code dir="auto">{}</code> — an empty object creates a stub to fill in later with <code dir="auto">PATCH</code>. Non-empty data is fully field-validated against the document type.</td><td><code dir="auto">{"label":"Hello"}</code></td></tr></tbody></table>
+<p>Creating a root node with its fields in one call:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-X</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">POST</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">http://localhost:3000/api/v1/content</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer </span><span style="--0:#C5E478;--1:#3B61B0">$VELORA_API_KEY</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Content-Type: application/json</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-d</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">{</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#ECC48D;--1:#984E4D">    </span></span><span style="--0:#ECC48D;--1:#984E4D">"documentTypeId": "d90012af-c528-4cff-b0c9-cc4c9cfc05c9",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#ECC48D;--1:#984E4D">    </span></span><span style="--0:#ECC48D;--1:#984E4D">"parentId": null,</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#ECC48D;--1:#984E4D">    </span></span><span style="--0:#ECC48D;--1:#984E4D">"slug": "hello-world",</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#ECC48D;--1:#984E4D">    </span></span><span style="--0:#ECC48D;--1:#984E4D">"data": { "label": "Hello world", "description": "First post." }</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#ECC48D;--1:#984E4D">  </span></span><span style="--0:#ECC48D;--1:#984E4D">}</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -X POST http://localhost:3000/api/v1/content \  -H &#x22;Authorization: Bearer $VELORA_API_KEY&#x22; \  -H &#x22;Content-Type: application/json&#x22; \  -d &#x27;{    &#x22;documentTypeId&#x22;: &#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,    &#x22;parentId&#x22;: null,    &#x22;slug&#x22;: &#x22;hello-world&#x22;,    &#x22;data&#x22;: { &#x22;label&#x22;: &#x22;Hello world&#x22;, &#x22;description&#x22;: &#x22;First post.&#x22; }  }&#x27;"><div></div></button></div></figure></div>
+<p>A success is <code dir="auto">201</code> with the node and its first version — note <code dir="auto">path</code> and
+<code dir="auto">version</code>, both server-derived:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/hello-world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">1</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">: { </span><span style="--0:#7FDBCA;--1:#096E72">"label"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">First post.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> }</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;id&#x22;: &#x22;b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30&#x22;,  &#x22;documentTypeId&#x22;: &#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,  &#x22;parentId&#x22;: null,  &#x22;path&#x22;: &#x22;/hello-world&#x22;,  &#x22;locale&#x22;: &#x22;en&#x22;,  &#x22;version&#x22;: 1,  &#x22;publishedAt&#x22;: null,  &#x22;data&#x22;: { &#x22;label&#x22;: &#x22;Hello world&#x22;, &#x22;description&#x22;: &#x22;First post.&#x22; }}"><div></div></button></div></figure></div>
+<p>Every property of a write response — the same shape for create, update and
+publish:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The node’s identity, needed for every follow-up call.</td><td><code dir="auto">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid)</td><td>The node’s document type.</td><td><code dir="auto">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</code></td></tr><tr><td><code dir="auto">parentId</code></td><td>string (uuid) or null</td><td>Parent node, or <code dir="auto">null</code> for a root.</td><td><code dir="auto">null</code></td></tr><tr><td><code dir="auto">path</code></td><td>string</td><td>Derived from the parent’s path and the slug. Not settable.</td><td><code dir="auto">/hello-world</code></td></tr><tr><td><code dir="auto">locale</code></td><td>string, at least 2 characters</td><td>The node’s locale.</td><td><code dir="auto">en</code></td></tr><tr><td><code dir="auto">version</code></td><td>positive integer</td><td>The version this write created — or, for publish, the one now current.</td><td><code dir="auto">1</code></td></tr><tr><td><code dir="auto">publishedAt</code></td><td>ISO datetime string or null</td><td><code dir="auto">null</code> until the node is published — a fresh node is a draft.</td><td><code dir="auto">null</code></td></tr><tr><td><code dir="auto">data</code></td><td>object</td><td>The field values now stored in that version.</td><td><code dir="auto">{"label":"Hello world"}</code></td></tr></tbody></table>
+<div class="sl-heading-wrapper level-h3"><h3 id="put-apiv1contentid--replace-all-fields"><code dir="auto">PUT /api/v1/content/:id</code> — replace all fields</h3><a class="sl-anchor-link" href="#put-apiv1contentid--replace-all-fields"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “PUT /api/v1/content/:id — replace all fields”</span></a></div>
+<p>The node’s data becomes exactly the request body’s <code dir="auto">data</code>, as a new
+version. The whole record is field-validated, so omitting a required field
+is a <code dir="auto">400</code>.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The node to write, in any publish state. Unknown = <code dir="auto">404</code>.</td><td><code dir="auto">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</code></td></tr><tr><td><code dir="auto">data</code></td><td>object, required</td><td>The complete new field set. Anything not listed is gone from the new version.</td><td><code dir="auto">{"label":"Hello, world"}</code></td></tr></tbody></table>
+<p>Replacing both fields of the node created above:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-X</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">PUT</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer </span><span style="--0:#C5E478;--1:#3B61B0">$VELORA_API_KEY</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Content-Type: application/json</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-d</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">{"data": {"label": "Hello, world", "description": "Rewritten."}}</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -X PUT http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30 \  -H &#x22;Authorization: Bearer $VELORA_API_KEY&#x22; \  -H &#x22;Content-Type: application/json&#x22; \  -d &#x27;{&#x22;data&#x22;: {&#x22;label&#x22;: &#x22;Hello, world&#x22;, &#x22;description&#x22;: &#x22;Rewritten.&#x22;}}&#x27;"><div></div></button></div></figure></div>
+<p>A success is <code dir="auto">200</code> with the write-response shape and <code dir="auto">version</code> incremented
+— version 1 still exists, untouched:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/hello-world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">2</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">: { </span><span style="--0:#7FDBCA;--1:#096E72">"label"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello, world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Rewritten.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> }</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;id&#x22;: &#x22;b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30&#x22;,  &#x22;documentTypeId&#x22;: &#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,  &#x22;parentId&#x22;: null,  &#x22;path&#x22;: &#x22;/hello-world&#x22;,  &#x22;locale&#x22;: &#x22;en&#x22;,  &#x22;version&#x22;: 2,  &#x22;publishedAt&#x22;: null,  &#x22;data&#x22;: { &#x22;label&#x22;: &#x22;Hello, world&#x22;, &#x22;description&#x22;: &#x22;Rewritten.&#x22; }}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="patch-apiv1contentid--change-some-fields"><code dir="auto">PATCH /api/v1/content/:id</code> — change some fields</h3><a class="sl-anchor-link" href="#patch-apiv1contentid--change-some-fields"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “PATCH /api/v1/content/:id — change some fields”</span></a></div>
+<p>The body’s <code dir="auto">data</code> keys are shallow-merged over the node’s latest version.
+The merge is per top-level key: an object or array field value is replaced
+whole, never deep-merged. The merged result is field-validated, so omitting
+a required field the node already has is fine.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The node to write, in any publish state.</td><td><code dir="auto">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</code></td></tr><tr><td><code dir="auto">data</code></td><td>object, required</td><td>Only the keys you want to change.</td><td><code dir="auto">{"description":"Edited."}</code></td></tr></tbody></table>
+<p>Changing one field and leaving the other alone:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-X</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">PATCH</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer </span><span style="--0:#C5E478;--1:#3B61B0">$VELORA_API_KEY</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Content-Type: application/json</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-d</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">{"data": {"description": "Edited."}}</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -X PATCH http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30 \  -H &#x22;Authorization: Bearer $VELORA_API_KEY&#x22; \  -H &#x22;Content-Type: application/json&#x22; \  -d &#x27;{&#x22;data&#x22;: {&#x22;description&#x22;: &#x22;Edited.&#x22;}}&#x27;"><div></div></button></div></figure></div>
+<p>A success is <code dir="auto">200</code>; the untouched <code dir="auto">label</code> is carried into the new version
+by the merge:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/hello-world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">3</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">: { </span><span style="--0:#7FDBCA;--1:#096E72">"label"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello, world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Edited.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> }</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;id&#x22;: &#x22;b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30&#x22;,  &#x22;documentTypeId&#x22;: &#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,  &#x22;parentId&#x22;: null,  &#x22;path&#x22;: &#x22;/hello-world&#x22;,  &#x22;locale&#x22;: &#x22;en&#x22;,  &#x22;version&#x22;: 3,  &#x22;publishedAt&#x22;: null,  &#x22;data&#x22;: { &#x22;label&#x22;: &#x22;Hello, world&#x22;, &#x22;description&#x22;: &#x22;Edited.&#x22; }}"><div></div></button></div></figure></div>
+<p>A write that fails validation is a <code dir="auto">400</code> carrying per-field failures:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">message</code></td><td>string</td><td>What failed, in one line: the fixed prefix <code dir="auto">Content validation failed: </code> followed by a comma-separated <code dir="auto">&#x3C;fieldId> (&#x3C;key>)</code> for each failing field, so the message alone is enough to log.</td><td><code dir="auto">Content validation failed: label (documentTypeForm.errors.required)</code></td></tr><tr><td><code dir="auto">fieldErrors</code></td><td>array</td><td>One entry per failing field. Empty for whole-record errors — an unknown document type, or a tree rule that forbids this placement; there the <code dir="auto">message</code> is that error’s own sentence instead.</td><td><code dir="auto">[…]</code></td></tr><tr><td><code dir="auto">fieldErrors[].fieldId</code></td><td>string</td><td>The field id that failed, matching a key in <code dir="auto">data</code>.</td><td><code dir="auto">label</code></td></tr><tr><td><code dir="auto">fieldErrors[].key</code></td><td>string</td><td>The rule that failed, as a translation key. One of <code dir="auto">documentTypeForm.errors.required</code>, <code dir="auto">.minLength</code>, <code dir="auto">.maxLength</code>, <code dir="auto">.pattern</code>, <code dir="auto">.min</code>, <code dir="auto">.max</code> — the same keys the admin editor’s own validator emits, so a client can feed them straight into its own translations.</td><td><code dir="auto">documentTypeForm.errors.required</code></td></tr><tr><td><code dir="auto">fieldErrors[].params</code></td><td>object, optional</td><td>The rule’s parameters, for building your own message. Present only for the four bounded rules.</td><td><code dir="auto">{"maxLength":120}</code></td></tr></tbody></table>
+<p>The body looks like this — schema-derived:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"message"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Content validation failed: label (documentTypeForm.errors.required)</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"fieldErrors"</span><span style="--0:#D6DEEB;--1:#403F53">: [{ </span><span style="--0:#7FDBCA;--1:#096E72">"fieldId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">label</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"key"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">documentTypeForm.errors.required</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> }]</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;message&#x22;: &#x22;Content validation failed: label (documentTypeForm.errors.required)&#x22;,  &#x22;fieldErrors&#x22;: [{ &#x22;fieldId&#x22;: &#x22;label&#x22;, &#x22;key&#x22;: &#x22;documentTypeForm.errors.required&#x22; }]}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="post-apiv1contentidpublish--make-it-readable"><code dir="auto">POST /api/v1/content/:id/publish</code> — make it readable</h3><a class="sl-anchor-link" href="#post-apiv1contentidpublish--make-it-readable"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “POST /api/v1/content/:id/publish — make it readable”</span></a></div>
+<p>Publishes the node’s latest saved version by repointing the current-version
+pointer. No new version row is created, and nothing is deleted — the
+previous current version stays in history.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The node to publish. Unknown = <code dir="auto">404</code> with the uniform read message.</td><td><code dir="auto">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</code></td></tr><tr><td><em>(no body)</em></td><td>—</td><td>Nothing to send.</td><td>—</td></tr></tbody></table>
+<p>Publishing the node:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-X</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">POST</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#ECC48D;--1:#3B61B0">http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30/publish</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer </span><span style="--0:#C5E478;--1:#3B61B0">$VELORA_API_KEY</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -X POST \  http://localhost:3000/api/v1/content/b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30/publish \  -H &#x22;Authorization: Bearer $VELORA_API_KEY&#x22;"><div></div></button></div></figure></div>
+<p>A success is <code dir="auto">200</code> with the write-response shape, now carrying a
+<code dir="auto">publishedAt</code> — from this moment the node answers on the read routes:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"documentTypeId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">d90012af-c528-4cff-b0c9-cc4c9cfc05c9</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"parentId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/hello-world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">3</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-31T09:41:22.180Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">: { </span><span style="--0:#7FDBCA;--1:#096E72">"label"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello, world</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Edited.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> }</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;id&#x22;: &#x22;b7c91f42-3d18-4a67-9e05-1c8f2b6d4a30&#x22;,  &#x22;documentTypeId&#x22;: &#x22;d90012af-c528-4cff-b0c9-cc4c9cfc05c9&#x22;,  &#x22;parentId&#x22;: null,  &#x22;path&#x22;: &#x22;/hello-world&#x22;,  &#x22;locale&#x22;: &#x22;en&#x22;,  &#x22;version&#x22;: 3,  &#x22;publishedAt&#x22;: &#x22;2026-08-31T09:41:22.180Z&#x22;,  &#x22;data&#x22;: { &#x22;label&#x22;: &#x22;Hello, world&#x22;, &#x22;description&#x22;: &#x22;Edited.&#x22; }}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h2"><h2 id="document-types">Document types</h2><a class="sl-anchor-link" href="#document-types"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Document types”</span></a></div>
+<p>Field values arrive keyed by field id, so a consumer that wants labels,
+data types or validation rules reads them from the document type. This is
+the introspection surface for interpreting <code dir="auto">data</code>.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1document-types"><code dir="auto">GET /api/v1/document-types</code></h3><a class="sl-anchor-link" href="#get-apiv1document-types"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/document-types”</span></a></div>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>Pagination cursor.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size, default <code dir="auto">50</code>.</td><td><code dir="auto">3</code></td></tr></tbody></table>
+<p>Listing three of the demo’s types:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/document-types?limit=3</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/document-types?limit=3&#x22;"><div></div></button></div></figure></div>
+<p>Each entry carries its fields inline — <strong>live</strong>, trimmed here to the first
+of the three for readability (the full response also contains <code dir="auto">Tag</code> and
+<code dir="auto">Post</code>):</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">511011a7-2a0b-42be-95c1-f6831d7dcbe6</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Author</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"icon"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">user</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"kind"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">page</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"fields"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">name</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Name</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000001</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"validation"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"required"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">true</span><span style="--0:#D6DEEB;--1:#403F53">}},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">bio</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Bio</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000006</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">avatar</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Avatar</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000005</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}]}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">f0491ccf-0511-43a7-862b-fdf9dce55f3c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;511011a7-2a0b-42be-95c1-f6831d7dcbe6&#x22;,&#x22;name&#x22;:&#x22;Author&#x22;,&#x22;icon&#x22;:&#x22;user&#x22;,&#x22;kind&#x22;:&#x22;page&#x22;,&#x22;fields&#x22;:[{&#x22;id&#x22;:&#x22;name&#x22;,&#x22;name&#x22;:&#x22;Name&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000001&#x22;,&#x22;validation&#x22;:{&#x22;required&#x22;:true}},{&#x22;id&#x22;:&#x22;bio&#x22;,&#x22;name&#x22;:&#x22;Bio&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000006&#x22;},{&#x22;id&#x22;:&#x22;avatar&#x22;,&#x22;name&#x22;:&#x22;Avatar&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000005&#x22;}]}],&#x22;nextCursor&#x22;:&#x22;f0491ccf-0511-43a7-862b-fdf9dce55f3c&#x22;}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1document-typesid"><code dir="auto">GET /api/v1/document-types/:id</code></h3><a class="sl-anchor-link" href="#get-apiv1document-typesid"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/document-types/:id”</span></a></div>
+<p>One type by id; unknown is a <code dir="auto">404</code> with
+<code dir="auto">{"message":"No document type found for id &#x3C;id>"}</code>.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The document type’s identity.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr></tbody></table>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/document-types/f0491ccf-0511-43a7-862b-fdf9dce55f3c</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/document-types/f0491ccf-0511-43a7-862b-fdf9dce55f3c&#x22;"><div></div></button></div></figure></div>
+<p>The demo’s <code dir="auto">Post</code> type — <strong>live</strong>. Its <code dir="auto">seo</code> field’s <code dir="auto">datatypeId</code> is a
+plugin-provided data type, which is what a plugin-contributed field looks
+like from outside:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">f0491ccf-0511-43a7-862b-fdf9dce55f3c</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Post</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"icon"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">file-text</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"kind"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">page</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"fields"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">title</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Title</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000001</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"validation"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"required"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">true</span><span style="--0:#D6DEEB;--1:#403F53">}},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">body</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Body</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000006</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"validation"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"required"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">true</span><span style="--0:#D6DEEB;--1:#403F53">}},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">featuredImage</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Featured Image</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000005</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">publishedDate</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Published Date</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000004</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">tags</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Tags (comma-separated slugs, e.g. </span><span style="--0:#F78C6C;--1:#AA0982">\"</span><span style="--0:#C789D6;--1:#7C5686">guides,announcements</span><span style="--0:#F78C6C;--1:#AA0982">\"</span><span style="--0:#C789D6;--1:#7C5686">)</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">b1e00000-0000-4000-8000-000000000001</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">seo</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"name"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">SEO</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"datatypeId"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">62b30a9d-e0b6-4189-8aa9-7371c8cd9c63</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}]}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;id&#x22;:&#x22;f0491ccf-0511-43a7-862b-fdf9dce55f3c&#x22;,&#x22;name&#x22;:&#x22;Post&#x22;,&#x22;icon&#x22;:&#x22;file-text&#x22;,&#x22;kind&#x22;:&#x22;page&#x22;,&#x22;fields&#x22;:[{&#x22;id&#x22;:&#x22;title&#x22;,&#x22;name&#x22;:&#x22;Title&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000001&#x22;,&#x22;validation&#x22;:{&#x22;required&#x22;:true}},{&#x22;id&#x22;:&#x22;body&#x22;,&#x22;name&#x22;:&#x22;Body&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000006&#x22;,&#x22;validation&#x22;:{&#x22;required&#x22;:true}},{&#x22;id&#x22;:&#x22;featuredImage&#x22;,&#x22;name&#x22;:&#x22;Featured Image&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000005&#x22;},{&#x22;id&#x22;:&#x22;publishedDate&#x22;,&#x22;name&#x22;:&#x22;Published Date&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000004&#x22;},{&#x22;id&#x22;:&#x22;tags&#x22;,&#x22;name&#x22;:&#x22;Tags (comma-separated slugs, e.g. \&#x22;guides,announcements\&#x22;)&#x22;,&#x22;datatypeId&#x22;:&#x22;b1e00000-0000-4000-8000-000000000001&#x22;},{&#x22;id&#x22;:&#x22;seo&#x22;,&#x22;name&#x22;:&#x22;SEO&#x22;,&#x22;datatypeId&#x22;:&#x22;62b30a9d-e0b6-4189-8aa9-7371c8cd9c63&#x22;}]}"><div></div></button></div></figure></div>
+<p>Every property of a document type on this surface:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The type’s identity — the <code dir="auto">documentTypeId</code> on every content row.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>Display name, and the stable handle a frontend should match on rather than hardcoding an id (ids are minted per instance).</td><td><code dir="auto">Post</code></td></tr><tr><td><code dir="auto">icon</code></td><td>string, non-empty</td><td>Icon name the admin renders.</td><td><code dir="auto">file-text</code></td></tr><tr><td><code dir="auto">kind</code></td><td><code dir="auto">"page"</code> or <code dir="auto">"element"</code></td><td>Whether nodes of this type live in the content tree (<code dir="auto">page</code>) or are embedded pieces (<code dir="auto">element</code>).</td><td><code dir="auto">page</code></td></tr><tr><td><code dir="auto">fields</code></td><td>array</td><td>The field definitions, in order.</td><td><code dir="auto">[…]</code></td></tr><tr><td><code dir="auto">fields[].id</code></td><td>string</td><td>The <strong>data key</strong> — this is the key in an item’s <code dir="auto">data</code>.</td><td><code dir="auto">title</code></td></tr><tr><td><code dir="auto">fields[].name</code></td><td>string, non-empty</td><td>Human label for the field.</td><td><code dir="auto">Title</code></td></tr><tr><td><code dir="auto">fields[].datatypeId</code></td><td>string, non-empty</td><td>Which data type stores the value; built-in ids start <code dir="auto">b1e00000-…</code>, plugin-provided ones are minted per install.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000001</code></td></tr><tr><td><code dir="auto">fields[].validation</code></td><td>object, optional</td><td>The client-facing rules: <code dir="auto">required</code>, <code dir="auto">minLength</code>, <code dir="auto">maxLength</code>, <code dir="auto">min</code>, <code dir="auto">max</code>, <code dir="auto">pattern</code>. Absent when the field has none.</td><td><code dir="auto">{"required":true}</code></td></tr></tbody></table>
+<p>The public projection is deliberately narrower than the admin one: tabs,
+tree rules and the default template id are admin concerns and are not
+exposed here. See <a href="/docs/v1/using-velora/content-model/">Content model</a> for
+those.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="media">Media</h2><a class="sl-anchor-link" href="#media"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Media”</span></a></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1media"><code dir="auto">GET /api/v1/media</code></h3><a class="sl-anchor-link" href="#get-apiv1media"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/media”</span></a></div>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>Pagination cursor.</td><td><code dir="auto">9f1d3b7c-52ae-4d08-9b31-6c74a0f5e218</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size, default <strong><code dir="auto">24</code></strong> — the only list on this surface that does not default to 50.</td><td><code dir="auto">24</code></td></tr><tr><td><code dir="auto">search</code></td><td>string, at least 1 character, optional</td><td>Filters by filename, server-side.</td><td><code dir="auto">logo</code></td></tr></tbody></table>
+<p>The demo’s media library is empty, so its answer is the empty envelope:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/media?limit=2</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/media?limit=2&#x22;"><div></div></button></div></figure></div>
+<p>That is what any list returns when nothing matches — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[],&#x22;nextCursor&#x22;:null}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1mediaid"><code dir="auto">GET /api/v1/media/:id</code></h3><a class="sl-anchor-link" href="#get-apiv1mediaid"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/media/:id”</span></a></div>
+<p>One file’s metadata plus a fresh download URL. Unknown is a <code dir="auto">404</code> with
+<code dir="auto">{"message":"No media file found for id &#x3C;id>"}</code>.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">:id</code></td><td>string (uuid), path parameter</td><td>The media file’s identity.</td><td><code dir="auto">9f1d3b7c-52ae-4d08-9b31-6c74a0f5e218</code></td></tr></tbody></table>
+<p>Nothing is uploaded on the demo, so this shape is schema-derived:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">9f1d3b7c-52ae-4d08-9b31-6c74a0f5e218</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"filename"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">cover.png</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"mimeType"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">image/png</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"size"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">48213</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"downloadUrl"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">https://s3.example.com/velora-media/9f1d3b7c/cover.png?X-Amz-Expires=900</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#7FDBCA;--1:#096E72">"uploadedAt"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-31T09:12:04.006Z</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{  &#x22;id&#x22;: &#x22;9f1d3b7c-52ae-4d08-9b31-6c74a0f5e218&#x22;,  &#x22;filename&#x22;: &#x22;cover.png&#x22;,  &#x22;mimeType&#x22;: &#x22;image/png&#x22;,  &#x22;size&#x22;: 48213,  &#x22;downloadUrl&#x22;: &#x22;https://s3.example.com/velora-media/9f1d3b7c/cover.png?X-Amz-Expires=900&#x22;,  &#x22;uploadedAt&#x22;: &#x22;2026-08-31T09:12:04.006Z&#x22;}"><div></div></button></div></figure></div>
+<p>Every property:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The file’s identity — this is the value an Image field stores in <code dir="auto">data</code>.</td><td><code dir="auto">9f1d3b7c-52ae-4d08-9b31-6c74a0f5e218</code></td></tr><tr><td><code dir="auto">filename</code></td><td>string, non-empty</td><td>The original filename, kept verbatim.</td><td><code dir="auto">cover.png</code></td></tr><tr><td><code dir="auto">mimeType</code></td><td>string, non-empty</td><td>Content type recorded at upload.</td><td><code dir="auto">image/png</code></td></tr><tr><td><code dir="auto">size</code></td><td>integer, 0 or more</td><td>Byte length, measured server-side.</td><td><code dir="auto">48213</code></td></tr><tr><td><code dir="auto">downloadUrl</code></td><td>string (URL)</td><td>A <strong>presigned GET</strong>, generated per response and valid for 900 seconds. Never persisted and never the same twice — refetch the record rather than caching the URL.</td><td><code dir="auto">https://s3.example.com/velora-media/…?X-Amz-Expires=900</code></td></tr><tr><td><code dir="auto">uploadedAt</code></td><td>ISO datetime string</td><td>When the record was written.</td><td><code dir="auto">2026-08-31T09:12:04.006Z</code></td></tr></tbody></table>
+<p>The uploader’s user id and the canonical object URL are on the admin shape
+only, deliberately — see <a href="/docs/v1/using-velora/media/">Media</a>. There is no
+public upload route: writes to the media library go through the admin API
+with a signed-in session.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="templates">Templates</h2><a class="sl-anchor-link" href="#templates"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Templates”</span></a></div>
+<div class="sl-heading-wrapper level-h3"><h3 id="get-apiv1templates"><code dir="auto">GET /api/v1/templates</code></h3><a class="sl-anchor-link" href="#get-apiv1templates"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GET /api/v1/templates”</span></a></div>
+<p>Templates are inert data in v1 — a name attached to a document type — so
+this route exists for consumers that render their own layouts by name.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>Pagination cursor.</td><td><code dir="auto">3f8a6c21-9d47-4b0e-8a15-7c2e9f4d6b83</code></td></tr><tr><td><code dir="auto">limit</code></td><td>integer 1–100</td><td>Page size, default <code dir="auto">50</code>.</td><td><code dir="auto">50</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid), optional</td><td>Only templates for this document type.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr></tbody></table>
+<p>The demo defines none:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/templates?limit=5</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/templates?limit=5&#x22;"><div></div></button></div></figure></div>
+<p>Again the empty envelope — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#FF6A83;--1:#A24848">null</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;items&#x22;:[],&#x22;nextCursor&#x22;:null}"><div></div></button></div></figure></div>
+<p>A populated instance returns rows of three properties:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">id</code></td><td>string (uuid)</td><td>The template’s identity.</td><td><code dir="auto">3f8a6c21-9d47-4b0e-8a15-7c2e9f4d6b83</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>Display name.</td><td><code dir="auto">Wide article</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid)</td><td>The document type this template belongs to.</td><td><code dir="auto">f0491ccf-0511-43a7-862b-fdf9dce55f3c</code></td></tr></tbody></table>
+<div class="sl-heading-wrapper level-h2"><h2 id="graphql">GraphQL</h2><a class="sl-anchor-link" href="#graphql"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GraphQL”</span></a></div>
+<p><code dir="auto">/api/v1/graphql</code> is a second protocol over the identical published-item
+pipeline — not a shim over REST, and not a different data set. Reach for
+it when one view needs several related things (a page, its children, a
+referenced media file) in one round trip. It is read-only: there are no
+mutations, so writes always go through the REST routes above.</p>
+<p>The endpoint is key-gated exactly like the REST routes. <code dir="auto">POST</code> with a JSON
+body is the usual call; <code dir="auto">GET</code> with a <code dir="auto">query</code> parameter is also supported,
+and is what the live transcripts below use. <code dir="auto">POST</code> works against the demo
+too — unlike the REST write routes, the demo’s edge proxy lets
+<code dir="auto">POST /api/v1/graphql</code> through, since a query-only schema has nothing to
+write.</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-sG</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/graphql</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">--data-urlencode</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">query={ contentRoots(limit: 2) { items { id path depth } nextCursor } }</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -sG &#x22;https://demo.velora-cms.com/api/v1/graphql&#x22; \  -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  --data-urlencode &#x27;query={ contentRoots(limit: 2) { items { id path depth } nextCursor } }&#x27;"><div></div></button></div></figure></div>
+<p>The response is the standard GraphQL envelope — <strong>live</strong> — carrying the
+same rows the REST roots list returns:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"contentRoots"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"items"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">acc3aefb-6254-465a-b088-c9578b2794af</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/jane-doe</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">},{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2e9053b1-a300-493f-a48b-58440cdf3629</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"path"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">/announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"depth"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">0</span><span style="--0:#D6DEEB;--1:#403F53">}],</span><span style="--0:#7FDBCA;--1:#096E72">"nextCursor"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2e9053b1-a300-493f-a48b-58440cdf3629</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}}}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;data&#x22;:{&#x22;contentRoots&#x22;:{&#x22;items&#x22;:[{&#x22;id&#x22;:&#x22;acc3aefb-6254-465a-b088-c9578b2794af&#x22;,&#x22;path&#x22;:&#x22;/jane-doe&#x22;,&#x22;depth&#x22;:0},{&#x22;id&#x22;:&#x22;2e9053b1-a300-493f-a48b-58440cdf3629&#x22;,&#x22;path&#x22;:&#x22;/announcements&#x22;,&#x22;depth&#x22;:0}],&#x22;nextCursor&#x22;:&#x22;2e9053b1-a300-493f-a48b-58440cdf3629&#x22;}}}"><div></div></button></div></figure></div>
+<p>Fetching one item’s fields by path is the GraphQL analogue of
+<code dir="auto">/api/v1/content/by-path</code>:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-sG</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/graphql</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#82AAFF;--1:#3B61B0">--data-urlencode</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">'</span><span style="--0:#ECC48D;--1:#984E4D">query={ contentByPath(path: "/jane-doe/hello-velora") { id locale version publishedAt data } }</span><span style="--0:#D9F5DD;--1:#111111">'</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -sG &#x22;https://demo.velora-cms.com/api/v1/graphql&#x22; \  -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  --data-urlencode &#x27;query={ contentByPath(path: &#x22;/jane-doe/hello-velora&#x22;) { id locale version publishedAt data } }&#x27;"><div></div></button></div></figure></div>
+<p><code dir="auto">data</code> comes back as a JSON scalar — the whole field object, exactly as
+REST serves it — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"contentByPath"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"id"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">afe5b000-d81e-4c51-b60a-1f5f04d6dacf</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"locale"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">en</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"version"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">3</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedAt"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-25T15:36:10.252Z</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"data"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"seo"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"title"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello, Velora — the capstone post</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"description"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">A published post proving the SEO plugin composes with the Blog starter on the deployed Velora demo.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">},</span><span style="--0:#7FDBCA;--1:#096E72">"body"</span><span style="--0:#D6DEEB;--1:#403F53">:{</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">doc</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"content"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">paragraph</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"content"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"text"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">This sample post was created by the Blog template. Edit or delete it freely.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">text</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}]},{</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">paragraph</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"content"</span><span style="--0:#D6DEEB;--1:#403F53">:[{</span><span style="--0:#7FDBCA;--1:#096E72">"text"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Updated live during the Session 168 capstone story.</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"type"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">text</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}]}]},</span><span style="--0:#7FDBCA;--1:#096E72">"tags"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">announcements</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"title"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Hello, Velora</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"publishedDate"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">2026-08-13</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}}}}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;data&#x22;:{&#x22;contentByPath&#x22;:{&#x22;id&#x22;:&#x22;afe5b000-d81e-4c51-b60a-1f5f04d6dacf&#x22;,&#x22;locale&#x22;:&#x22;en&#x22;,&#x22;version&#x22;:3,&#x22;publishedAt&#x22;:&#x22;2026-08-25T15:36:10.252Z&#x22;,&#x22;data&#x22;:{&#x22;seo&#x22;:{&#x22;title&#x22;:&#x22;Hello, Velora — the capstone post&#x22;,&#x22;description&#x22;:&#x22;A published post proving the SEO plugin composes with the Blog starter on the deployed Velora demo.&#x22;},&#x22;body&#x22;:{&#x22;type&#x22;:&#x22;doc&#x22;,&#x22;content&#x22;:[{&#x22;type&#x22;:&#x22;paragraph&#x22;,&#x22;content&#x22;:[{&#x22;text&#x22;:&#x22;This sample post was created by the Blog template. Edit or delete it freely.&#x22;,&#x22;type&#x22;:&#x22;text&#x22;}]},{&#x22;type&#x22;:&#x22;paragraph&#x22;,&#x22;content&#x22;:[{&#x22;text&#x22;:&#x22;Updated live during the Session 168 capstone story.&#x22;,&#x22;type&#x22;:&#x22;text&#x22;}]}]},&#x22;tags&#x22;:&#x22;announcements&#x22;,&#x22;title&#x22;:&#x22;Hello, Velora&#x22;,&#x22;publishedDate&#x22;:&#x22;2026-08-13&#x22;}}}}"><div></div></button></div></figure></div>
+<p>Every query on the schema, with its arguments:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">content</code></td><td><code dir="auto">PublicContentItem</code>, nullable</td><td>One item by id. Arguments: <code dir="auto">id!</code>, <code dir="auto">locale</code>, <code dir="auto">fallback</code>, <code dir="auto">previewToken</code>. Null for unknown, draft and unresolvable-translation alike.</td><td><code dir="auto">content(id: "acc3aefb-…") { data }</code></td></tr><tr><td><code dir="auto">contentByPath</code></td><td><code dir="auto">PublicContentItem</code>, nullable</td><td>One item by tree path. Arguments: <code dir="auto">path!</code>, <code dir="auto">locale</code>, <code dir="auto">fallback</code>. No preview token on this query.</td><td><code dir="auto">contentByPath(path: "/announcements") { id }</code></td></tr><tr><td><code dir="auto">contentRoots</code></td><td><code dir="auto">ContentNodeConnection</code></td><td>Published root nodes. Arguments: <code dir="auto">cursor</code>, <code dir="auto">limit</code>. Never null.</td><td><code dir="auto">contentRoots(limit: 2) { items { path } }</code></td></tr><tr><td><code dir="auto">contentChildren</code></td><td><code dir="auto">ContentNodeConnection</code>, nullable</td><td>Direct children of a published node. Arguments: <code dir="auto">id!</code>, <code dir="auto">cursor</code>, <code dir="auto">limit</code>. Null when the parent is unknown or unpublished.</td><td><code dir="auto">contentChildren(id: "acc3aefb-…") { items { path } }</code></td></tr><tr><td><code dir="auto">contents</code></td><td><code dir="auto">ContentNodeConnection</code>, nullable</td><td>Filtered search. Arguments: <code dir="auto">documentTypeId</code>, <code dir="auto">under</code>, <code dir="auto">q</code>, <code dir="auto">cursor</code>, <code dir="auto">limit</code>. Null when <code dir="auto">under</code> names no published node.</td><td><code dir="auto">contents(q: "hello") { items { id } }</code></td></tr><tr><td><code dir="auto">documentType</code></td><td><code dir="auto">PublicDocumentType</code>, nullable</td><td>One document type by id. Argument: <code dir="auto">id!</code>.</td><td><code dir="auto">documentType(id: "f0491ccf-…") { name }</code></td></tr><tr><td><code dir="auto">documentTypes</code></td><td><code dir="auto">DocumentTypeConnection</code></td><td>All document types. Arguments: <code dir="auto">cursor</code>, <code dir="auto">limit</code>. Never null.</td><td><code dir="auto">documentTypes { items { name } }</code></td></tr><tr><td><code dir="auto">templates</code></td><td><code dir="auto">TemplateConnection</code></td><td>Templates. Arguments: <code dir="auto">cursor</code>, <code dir="auto">limit</code>, <code dir="auto">documentTypeId</code>. Never null.</td><td><code dir="auto">templates { items { name } }</code></td></tr><tr><td><code dir="auto">mediaItem</code></td><td><code dir="auto">PublicMediaFile</code>, nullable</td><td>One media file by id. Argument: <code dir="auto">id!</code>.</td><td><code dir="auto">mediaItem(id: "9f1d3b7c-…") { downloadUrl }</code></td></tr><tr><td><code dir="auto">media</code></td><td><code dir="auto">MediaConnection</code></td><td>The media library. Arguments: <code dir="auto">cursor</code>, <code dir="auto">limit</code>, <code dir="auto">search</code>. Never null.</td><td><code dir="auto">media(limit: 5) { items { filename } }</code></td></tr></tbody></table>
+<p>Every connection type has the same two fields, <code dir="auto">items</code> and <code dir="auto">nextCursor</code>,
+and the object types carry exactly the properties the REST tables above
+describe. Argument validation is shared with REST: a <code dir="auto">limit</code> outside 1–100
+or a <code dir="auto">q</code> under two characters is an entry in the response’s <code dir="auto">errors</code>
+array, never a silent clamp.</p>
+<p>Two guards apply to every operation:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>Depth limit</td><td>integer</td><td>Rejects a query nested deeper than <code dir="auto">VELORA_GRAPHQL_MAX_DEPTH</code>. Default <code dir="auto">8</code>.</td><td><code dir="auto">8</code></td></tr><tr><td>Complexity limit</td><td>integer</td><td>Rejects an operation selecting more than <code dir="auto">VELORA_GRAPHQL_MAX_COMPLEXITY</code> fields. Every field selection counts 1; aliased duplicates each count; a fragment’s fields count once <strong>per spread site</strong>, so spreading one shared fragment into ten aliased roots costs ten times its fields. Default <code dir="auto">500</code>.</td><td><code dir="auto">500</code></td></tr></tbody></table>
+<p>Introspection is disabled unless <code dir="auto">VELORA_PUBLIC_DOCS</code> is on, so a hardened
+deployment answers queries but will not describe its own schema.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="graphiql">GraphiQL</h3><a class="sl-anchor-link" href="#graphiql"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “GraphiQL”</span></a></div>
+<p>When <code dir="auto">VELORA_PUBLIC_DOCS</code> is on, an in-browser explorer is served at
+<code dir="auto">/api/v1/graphiql</code>. The page itself is not key-gated — it is HTML and
+JavaScript, like a Swagger UI — but every query it sends is, so opening it
+without a key shows the schema, not the data.</p>
+<p>The demo has <code dir="auto">VELORA_PUBLIC_DOCS</code> on, and its edge proxy allows
+<code dir="auto">POST /api/v1/graphql</code>, so GraphiQL is fully usable there — <strong>live</strong> at
+<a href="https://demo.velora-cms.com/api/v1/graphiql">demo.velora-cms.com/api/v1/graphiql</a>,
+key and all.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="openapi">OpenAPI</h2><a class="sl-anchor-link" href="#openapi"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “OpenAPI”</span></a></div>
+<p><code dir="auto">/api/v1/docs</code> is a Swagger UI generated from the same Zod schemas the
+routes validate against, filtered to the public surface only — the admin
+API never appears in it. It is served when <code dir="auto">VELORA_HEADLESS</code> <strong>and</strong>
+<code dir="auto">VELORA_PUBLIC_DOCS</code> are both on; turning the latter off <code dir="auto">404</code>s the docs
+while the API keeps answering, which is the usual post-launch hardening
+step.</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-si</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/docs</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#7FDBCA;--1:#096E72">|</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">head</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-1</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -si &#x22;https://demo.velora-cms.com/api/v1/docs&#x22; | head -1"><div></div></button></div></figure></div>
+<p>The demo serves it — <strong>live</strong> — so the generated reference is browsable
+alongside this page:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="plaintext"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">HTTP/1.1 200 OK</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="HTTP/1.1 200 OK"><div></div></button></div></figure></div>
+<p>GraphQL is deliberately absent from that spec: an arbitrary
+query/variables body is not expressible in OpenAPI, which is why the
+GraphQL surface gets GraphiQL instead.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="errors">Errors</h2><a class="sl-anchor-link" href="#errors"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Errors”</span></a></div>
+<p>Every error body on this surface is JSON with a <code dir="auto">message</code>. Validation
+failures add <code dir="auto">fieldErrors</code>; rate-limit rejections add <code dir="auto">statusCode</code>. <code dir="auto">401</code>
+and <code dir="auto">403</code> are distinct answers: <code dir="auto">401</code> means the key was not accepted at
+all, <code dir="auto">403</code> means it was accepted and is not allowed to write.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">400</code></td><td>Bad Request</td><td>A parameter failed schema validation, an unknown <code dir="auto">format</code> was asked for, or a write failed field validation (then <code dir="auto">fieldErrors</code> is present).</td><td><code dir="auto">{"message":"Unknown format nope:thing"}</code></td></tr><tr><td><code dir="auto">401</code></td><td>Unauthorized</td><td>No key, a malformed key, an unknown key, or a revoked key. Always the same body.</td><td><code dir="auto">{"message":"A valid API key is required"}</code></td></tr><tr><td><code dir="auto">403</code></td><td>Forbidden</td><td>A valid, unrevoked <code dir="auto">read</code> key on one of the four write routes. Reads never answer <code dir="auto">403</code>.</td><td><code dir="auto">{"message":"This API key is read-only"}</code></td></tr><tr><td><code dir="auto">404</code></td><td>Not Found</td><td>On reads, the uniform published-only miss. <code dir="auto">POST /api/v1/content</code> and <code dir="auto">PUT</code>/<code dir="auto">PATCH /api/v1/content/:id</code> name the id or parent id that was not found; <code dir="auto">POST /api/v1/content/:id/publish</code> answers the same uniform read message instead.</td><td><code dir="auto">{"message":"No published content found"}</code></td></tr><tr><td><code dir="auto">429</code></td><td>Too Many Requests</td><td>The rate limit for your lane. Carries a <code dir="auto">Retry-After</code> header.</td><td><code dir="auto">{"statusCode":429,"message":"Rate limit exceeded, retry in 42 seconds"}</code></td></tr><tr><td><code dir="auto">500</code></td><td>Internal Server Error</td><td>Rare and specific: a node whose current-version pointer has no matching version row.</td><td><code dir="auto">{"message":"current_version (3) for … has no matching content version"}</code></td></tr></tbody></table>
+<p>A querystring that fails validation answers Fastify’s validation body,
+which names the offending parameter:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-s</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content?limit=500</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -s -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content?limit=500&#x22;"><div></div></button></div></figure></div>
+<p>The message names both the field and the rule — <strong>live</strong>:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="json"><code><div class="ec-line"><div class="code"><span style="--0:#D6DEEB;--1:#403F53">{</span><span style="--0:#7FDBCA;--1:#096E72">"statusCode"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#F78C6C;--1:#AA0982">400</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"code"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">FST_ERR_VALIDATION</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"error"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Bad Request</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">,</span><span style="--0:#7FDBCA;--1:#096E72">"message"</span><span style="--0:#D6DEEB;--1:#403F53">:</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">querystring/limit Too big: expected number to be &#x3C;=100</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">}</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="{&#x22;statusCode&#x22;:400,&#x22;code&#x22;:&#x22;FST_ERR_VALIDATION&#x22;,&#x22;error&#x22;:&#x22;Bad Request&#x22;,&#x22;message&#x22;:&#x22;querystring/limit Too big: expected number to be <=100&#x22;}"><div></div></button></div></figure></div>
+<div class="sl-heading-wrapper level-h2"><h2 id="rate-limits">Rate limits</h2><a class="sl-anchor-link" href="#rate-limits"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Rate limits”</span></a></div>
+<p>Requests are bucketed by what they actually present, and each bucket has
+its own ceiling.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>Key lane</td><td>integer per window</td><td>A <code dir="auto">vk_</code> token that resolves to a real, unrevoked key gets its own bucket, <code dir="auto">VELORA_RATE_LIMIT_MAX</code> requests per window. Default <code dir="auto">100</code>.</td><td><code dir="auto">100</code></td></tr><tr><td>Anonymous lane</td><td>integer per window</td><td>No token, or a <code dir="auto">vk_</code>-shaped token that does not resolve, falls back to a per-IP bucket capped at <code dir="auto">VELORA_RATE_LIMIT_IP_MAX</code>. Default <code dir="auto">60</code>. This is why minting random <code dir="auto">vk_</code> strings cannot buy a bigger allowance.</td><td><code dir="auto">60</code></td></tr><tr><td>Window</td><td>duration string</td><td><code dir="auto">VELORA_RATE_LIMIT_WINDOW</code>, default <code dir="auto">1 minute</code>.</td><td><code dir="auto">1 minute</code></td></tr></tbody></table>
+<p>Every response carries the current state of your bucket:</p>
+<div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="sh"><code><div class="ec-line"><div class="code"><span style="--0:#82AAFF;--1:#3B61B0">curl</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-si</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-H</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">Authorization: Bearer vk_4ac0…9328</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#F78C6C;--1:#AA0982">\</span></div></div><div class="ec-line"><div class="code"><span class="indent">  </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#ECC48D;--1:#984E4D">https://demo.velora-cms.com/api/v1/content?limit=1</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#7FDBCA;--1:#096E72">|</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">grep</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#82AAFF;--1:#3B61B0">-i</span><span style="--0:#D6DEEB;--1:#403F53"> </span><span style="--0:#ECC48D;--1:#3B61B0">ratelimit</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="curl -si -H &#x22;Authorization: Bearer vk_4ac0…9328&#x22; \  &#x22;https://demo.velora-cms.com/api/v1/content?limit=1&#x22; | grep -i ratelimit"><div></div></button></div></figure></div>
+<p>Three headers come back — <strong>live</strong>, from a demo call partway through its
+window:</p>
+<div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="plaintext"><code><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">x-ratelimit-limit: 100</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">x-ratelimit-remaining: 93</span></div></div><div class="ec-line"><div class="code"><span style="--0:#d6deeb;--1:#403f53">x-ratelimit-reset: 19</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copy to clipboard" data-copied="Copied!" data-code="x-ratelimit-limit: 100x-ratelimit-remaining: 93x-ratelimit-reset: 19"><div></div></button></div></figure></div>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">x-ratelimit-limit</code></td><td>integer</td><td>The ceiling for your lane.</td><td><code dir="auto">100</code></td></tr><tr><td><code dir="auto">x-ratelimit-remaining</code></td><td>integer</td><td>Requests left in this window.</td><td><code dir="auto">93</code></td></tr><tr><td><code dir="auto">x-ratelimit-reset</code></td><td>integer (seconds)</td><td>Seconds until the window rolls over.</td><td><code dir="auto">19</code></td></tr><tr><td><code dir="auto">retry-after</code></td><td>integer (seconds)</td><td>Sent on a <code dir="auto">429</code> only.</td><td><code dir="auto">19</code></td></tr></tbody></table>
+<p>Revoking a key stops it immediately — every request is re-checked against
+the database — even though the rate limiter may keep that key’s bucket for
+up to 30 seconds afterwards. The bucket grants no access; it is only
+bookkeeping.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="next">Next</h2><a class="sl-anchor-link" href="#next"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 1 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 0 0-1.42-1.42m8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 1 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 0 0 0 1.42 1 1 0 0 0 1.42 0l3.88-3.89a4.49 4.49 0 0 0 0-6.33M8.83 15.17a1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.92-4.92a1 1 0 1 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42"></path></svg></span><span class="sr-only" data-pagefind-ignore="">Section titled “Next”</span></a></div>
+<ul>
+<li><a href="/docs/v1/using-velora/build-a-headless-frontend/">Build a headless frontend</a> —
+a working site on these endpoints, one file, no dependencies.</li>
+<li><a href="/docs/v1/using-velora/users-and-roles/">Users and roles</a> — creating, listing
+and revoking API keys.</li>
+<li><a href="/docs/v1/using-velora/content-model/">Content model</a> — where document types,
+fields and tree rules come from.</li>
+<li><a href="/docs/v1/using-velora/editing/">Editing</a> — what a version is, and why
+publishing never deletes anything.</li>
+</ul></div><footer class="sl-flex astro-gjkl2a5w"><div class="meta sl-flex astro-gjkl2a5w"></div><div class="pagination-links print:hidden astro-3tj6ibx2" dir="ltr"><a href="/docs/v1/using-velora/installing-plugins/" rel="prev" class="astro-3tj6ibx2"><svg aria-hidden="true" class="astro-3tj6ibx2 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17 11H9.41l3.3-3.29a1.004 1.004 0 1 0-1.42-1.42l-5 5a1 1 0 0 0-.21.33 1 1 0 0 0 0 .76 1 1 0 0 0 .21.33l5 5a1.002 1.002 0 0 0 1.639-.325 1 1 0 0 0-.219-1.095L9.41 13H17a1 1 0 0 0 0-2Z"/></svg><span class="astro-3tj6ibx2">Previous<br class="astro-3tj6ibx2"><span class="link-title astro-3tj6ibx2">Installing plugins</span></span></a><a href="/docs/v1/using-velora/build-a-headless-frontend/" rel="next" class="astro-3tj6ibx2"><svg aria-hidden="true" class="astro-3tj6ibx2 astro-24n5ceuf" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17.92 11.62a1.001 1.001 0 0 0-.21-.33l-5-5a1.003 1.003 0 1 0-1.42 1.42l3.3 3.29H7a1 1 0 0 0 0 2h7.59l-3.3 3.29a1.002 1.002 0 0 0 .325 1.639 1 1 0 0 0 1.095-.219l5-5a1 1 0 0 0 .21-.33 1 1 0 0 0 0-.76Z"/></svg><span class="astro-3tj6ibx2">Next<br class="astro-3tj6ibx2"><span class="link-title astro-3tj6ibx2">Build a headless frontend</span></span></a></div></footer><div class="velora-bundle-stamp astro-llmj63sw">Velora 0.9.0 &middot; bundled documentation</div></div></div></main></div></div></div></div></body></html>