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/content-model/index.html ADDED Viewed

@@ -0,0 +1,858 @@
+<!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>Document types | 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="Document types"/><meta property="og:type" content="article"/><meta property="og:locale" content="en"/><meta property="og:description" content="Model your content — the page/element split, fields, tabs, tree rules, data types, and the admin API that creates them."/><meta property="og:site_name" content="Velora"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Model your content — the page/element split, fields, tabs, tree rules, data types, and the admin API that creates them."/><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/" aria-current="page" 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/" 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="#page-types-and-element-types" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Page types and element types</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#the-properties-of-a-document-type" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">The properties of a document type</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#fields" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Fields</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#tabs" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Tabs</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#data-types-and-the-built-in-editors" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Data types and the built-in editors</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#tree-rules" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Tree rules</span></a><ul class="isMobile astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#reserved-root-slugs" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Reserved root slugs</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#locales" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Locales</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#templates-are-inert-in-v1" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Templates are inert in v1</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#a-worked-example-a-page-type-in-the-admin" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">A worked example: a Page type in the admin</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#the-same-thing-over-the-admin-api" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">The same thing over the admin API</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#how-ids-are-minted" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">How ids are minted</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="#page-types-and-element-types" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Page types and element types</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#the-properties-of-a-document-type" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">The properties of a document type</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#fields" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Fields</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#tabs" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Tabs</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#data-types-and-the-built-in-editors" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Data types and the built-in editors</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#tree-rules" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Tree rules</span></a><ul class="astro-lptfoybu" style="--depth: 1;"><li style="--depth: 1;" class="astro-lptfoybu"><a href="#reserved-root-slugs" style="--depth: 1;" class="astro-lptfoybu"><span style="--depth: 1;" class="astro-lptfoybu">Reserved root slugs</span></a></li></ul></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#locales" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Locales</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#templates-are-inert-in-v1" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">Templates are inert in v1</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#a-worked-example-a-page-type-in-the-admin" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">A worked example: a Page type in the admin</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#the-same-thing-over-the-admin-api" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">The same thing over the admin API</span></a></li><li style="--depth: 0;" class="astro-lptfoybu"><a href="#how-ids-are-minted" style="--depth: 0;" class="astro-lptfoybu"><span style="--depth: 0;" class="astro-lptfoybu">How ids are minted</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">Document types</h1></div></div><div class="content-panel astro-ahkzlqop"><div class="sl-container astro-ahkzlqop"><div class="sl-markdown-content"><p>A document type is the shape of a piece of content: which fields it has,
+how those fields are grouped into tabs in the editor, and — for content
+that lives in the tree — where it is allowed to sit. Every content item
+you create is an instance of some document type; the type defines what
+you are allowed to fill in, the item just holds the values.</p>
+<p>Document types are edited in the admin under <strong>Settings → Document
+Types</strong>, and over the admin API at <code dir="auto">/api/document-types</code>. Both go through
+the same service, so nothing below is admin-only behaviour.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="page-types-and-element-types">Page types and element types</h2><a class="sl-anchor-link" href="#page-types-and-element-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 “Page types and element types”</span></a></div>
+<p>Every document type is one of two kinds, chosen when it is created and
+fixed afterwards — <code dir="auto">kind</code> is absent from the update request schema
+entirely, so there is no “change the kind” call to make:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">page</code></td><td>literal <code dir="auto">"page"</code></td><td>Lives in the content tree: it has a <code dir="auto">path</code>, a position, and <code dir="auto">treeRules</code> governing where it may sit. This is the kind you create content with.</td><td>A <code dir="auto">Page</code>, <code dir="auto">Post</code>, or <code dir="auto">Author</code> type</td></tr><tr><td><code dir="auto">element</code></td><td>literal <code dir="auto">"element"</code></td><td>A shape of fields with no tree position — no path, no URL, no <code dir="auto">treeRules</code>. Intended for reusable blocks (a call-to-action, a testimonial, an SEO block) that should not clutter the tree.</td><td>An <code dir="auto">SEO block</code> type</td></tr></tbody></table>
+<p>Element types can be defined today — fields, tabs, the same builder a
+page type uses — but there is <strong>no authoring path for them yet</strong>: the
+content service rejects an element type at any tree position including
+the root (<code dir="auto">element-kind-not-placeable</code>), and the admin’s create menu only
+ever offers page types. Defining one today reserves the shape for later;
+it does not let you create content with it.</p>
+<p>Reach for a page type whenever the content needs its own address in the
+tree, which in v1 is every piece of content you will actually author.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-properties-of-a-document-type">The properties of a document type</h2><a class="sl-anchor-link" href="#the-properties-of-a-document-type"><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 properties of a document type”</span></a></div>
+<p>These are the properties <code dir="auto">DocumentTypeDefinitionSchema</code>
+(<code dir="auto">packages/api-schemas/src/document-type.schema.ts</code>) defines — the shape of
+one <strong>item</strong> in a <code dir="auto">GET /api/document-types</code> response, which itself wraps a
+page of these as <code dir="auto">{ items, nextCursor }</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)</td><td>Server-minted identity. Never sent on create — the service mints it.</td><td><code dir="auto">7a2f1c40-9b31-4d6a-8f0e-2c5b7d1a4e93</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>Display name in the admin and in the create menu. Must be unique within one plugin’s manifest; core does not otherwise enforce uniqueness.</td><td><code dir="auto">Page</code></td></tr><tr><td><code dir="auto">icon</code></td><td>string, may be empty</td><td>Optional icon name, chosen from the admin’s curated picker (kebab-case). The admin shows it in the content tree, the create form and the editor’s info tab; an empty value renders the default document icon. Stored and returned by the API (including the public <code dir="auto">/api/v1/document-types</code>).</td><td><code dir="auto">file-text</code></td></tr><tr><td><code dir="auto">kind</code></td><td><code dir="auto">"page"</code> | <code dir="auto">"element"</code></td><td>The discriminator for the two branches above. Immutable after creation.</td><td><code dir="auto">page</code></td></tr><tr><td><code dir="auto">fields</code></td><td>array of field definitions</td><td>The fields content of this type carries. Order is array order. May be empty.</td><td><code dir="auto">[{ "id": "title", … }]</code></td></tr><tr><td><code dir="auto">tabs</code></td><td>array of tab definitions, default <code dir="auto">[]</code></td><td>Editor tab groups. <code dir="auto">[]</code> renders one flat field list.</td><td><code dir="auto">[]</code></td></tr><tr><td><code dir="auto">treeRules</code></td><td>object, <strong><code dir="auto">page</code> kind only</strong></td><td>Where content of this type may sit. Required on <code dir="auto">page</code>, rejected on <code dir="auto">element</code> — both branches are strict, so a stray key is an error rather than being silently dropped.</td><td><code dir="auto">{ "allowedAtRoot": true, "allowedParentTypes": [], "allowedChildTypes": [] }</code></td></tr><tr><td><code dir="auto">defaultTemplateId</code></td><td>string (uuid), optional, <code dir="auto">page</code> kind only</td><td>Pointer to a template. Never set at create time — a template cannot exist before its document type does; set it afterwards with <code dir="auto">PATCH /api/document-types/:id/default-template</code>.</td><td><code dir="auto">3d9c81e2-5b47-4a10-9f6d-08c2a7b31f45</code></td></tr></tbody></table>
+<div class="sl-heading-wrapper level-h2"><h2 id="fields">Fields</h2><a class="sl-anchor-link" href="#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 “Fields”</span></a></div>
+<p>A field is one editable value on the type. Its <code dir="auto">id</code> is the key the value
+is stored under in the content version’s <code dir="auto">data</code> object, which is why
+renaming a field’s display <code dir="auto">name</code> later never orphans existing content —
+only the <code dir="auto">id</code> matters to stored data, and it is the one thing you should
+not change.</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 matching <code dir="auto">^[a-zA-Z][a-zA-Z0-9_]*$</code></td><td>The data key: starts with a letter, then letters, digits, and underscores. Must be unique within the type — a duplicate is a validation error naming the offending index, because two fields sharing a key would silently collide in stored data.</td><td><code dir="auto">title</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>The label shown above the input in the editor. Free to change at any time.</td><td><code dir="auto">Title</code></td></tr><tr><td><code dir="auto">datatypeId</code></td><td>string, non-empty</td><td>References a <strong>Data Type</strong> configuration id (see below), not an editor id directly. The route rejects the create or update if no data type row has this id.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000001</code></td></tr><tr><td><code dir="auto">validation</code></td><td>object, optional</td><td>Per-field rules — see the table below. Deliberately per field, not on the Data Type, so the same Data Type can be required on one type and optional on another.</td><td><code dir="auto">{ "required": true, "maxLength": 120 }</code></td></tr><tr><td><code dir="auto">tabId</code></td><td>string (uuid), optional</td><td>Which tab this field renders under. Must reference a tab declared in the same payload, or the request is rejected. Omit it and the field renders in the implicit default group.</td><td><code dir="auto">9c1e5b70-4a62-4f83-b0d1-7e2f6a48c531</code></td></tr></tbody></table>
+<p>The validation object is <code dir="auto">FieldValidationSchema</code>. Every key in it is
+optional, and the whole object may be omitted:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">required</code></td><td>boolean</td><td>Rejects <code dir="auto">undefined</code>, <code dir="auto">null</code>, and <code dir="auto">""</code> on save. Deliberately does <strong>not</strong> reject <code dir="auto">false</code> or <code dir="auto">0</code> — those are real values for a boolean or number field, not emptiness.</td><td><code dir="auto">true</code></td></tr><tr><td><code dir="auto">minLength</code></td><td>integer ≥ 0</td><td>Minimum string length. Applied only when the stored value is a string. Must be ≤ <code dir="auto">maxLength</code>, or the document type itself fails validation.</td><td><code dir="auto">3</code></td></tr><tr><td><code dir="auto">maxLength</code></td><td>integer ≥ 0</td><td>Maximum string length. Distinct from the Text Data Type’s own <code dir="auto">maxLength</code> setting, which physically blocks typing in the browser; this one is a rule checked when content is saved.</td><td><code dir="auto">120</code></td></tr><tr><td><code dir="auto">min</code></td><td>number</td><td>Minimum numeric value. Applied only when the stored value is a number. Must be ≤ <code dir="auto">max</code>.</td><td><code dir="auto">0</code></td></tr><tr><td><code dir="auto">max</code></td><td>number</td><td>Maximum numeric value.</td><td><code dir="auto">100</code></td></tr><tr><td><code dir="auto">pattern</code></td><td>string, non-empty</td><td>A regular expression source (no flags) the value must match. An empty string is left to <code dir="auto">required</code> to judge; a pattern that fails to compile validates as a pass rather than bricking every save of existing content.</td><td><code dir="auto">^[a-z0-9-]+$</code></td></tr></tbody></table>
+<p>These rules are enforced on the server when content is saved, not only in
+the browser — see <a href="/docs/v1/using-velora/editing/">Content editing</a> for the
+error body a failed save returns.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="tabs">Tabs</h2><a class="sl-anchor-link" href="#tabs"><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 “Tabs”</span></a></div>
+<p>Tabs group fields into the strip across the top of the content editor.
+They are flat — one level of tabs, not tabs inside groups — and their
+order is their position in the array.</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>Referenced by a field’s <code dir="auto">tabId</code>. Purely organizational: unlike a field id it is never a data key, so it is a generated uuid rather than a typed key.</td><td><code dir="auto">9c1e5b70-4a62-4f83-b0d1-7e2f6a48c531</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>The tab label in the editor.</td><td><code dir="auto">Content</code></td></tr></tbody></table>
+<p>A type with <code dir="auto">tabs: []</code> still gets one tab in the editor, labelled
+<strong>Content</strong>, so the tab strip is present on every item.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="data-types-and-the-built-in-editors">Data types and the built-in editors</h2><a class="sl-anchor-link" href="#data-types-and-the-built-in-editors"><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 “Data types and the built-in editors”</span></a></div>
+<p>A field does not reference an editor directly. It references a <strong>Data
+Type</strong>: a named, admin-configured instance of a registered editor — “Text
+— 200 char limit” is a configured instance of the Text editor. Configure
+a Data Type once under <strong>Settings → Data Types</strong>, then reuse it across as
+many fields and document types as you like.</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 id a field’s <code dir="auto">datatypeId</code> points at.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000001</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>How this configuration appears when you pick a datatype in the document type builder.</td><td><code dir="auto">Text — 200 char limit</code></td></tr><tr><td><code dir="auto">editorId</code></td><td>string, non-empty</td><td>The registered editor this configures. <strong>Immutable after creation</strong> — swapping the editor under fields that already store values in the old editor’s shape would corrupt them, so the update schema has no <code dir="auto">editorId</code> key at all.</td><td><code dir="auto">com.velora.text</code></td></tr><tr><td><code dir="auto">settings</code></td><td>object, default <code dir="auto">{}</code></td><td>The editor’s own settings, validated against that editor’s settings schema.</td><td><code dir="auto">{ "maxLength": 200 }</code></td></tr></tbody></table>
+<p>Six editors are built in, and each seeds a default Data Type
+configuration on migration with a <strong>fixed, known id</strong> — so the builder
+works out of the box and you can reference these ids directly without a
+lookup. The Example column below is the seeded configuration id you would
+put in a field’s <code dir="auto">datatypeId</code>:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>Text</td><td><code dir="auto">com.velora.text</code>, stores a <code dir="auto">string</code></td><td>Single-line text. Settings: <code dir="auto">placeholder</code>, and <code dir="auto">maxLength</code>, which hard-blocks typing past that many characters in the browser.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000001</code></td></tr><tr><td>Number</td><td><code dir="auto">com.velora.number</code>, stores a <code dir="auto">number</code></td><td>A numeric input. Clearing the input stores <code dir="auto">null</code>, not <code dir="auto">0</code>. No settings.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000002</code></td></tr><tr><td>Boolean</td><td><code dir="auto">com.velora.boolean</code>, stores a <code dir="auto">boolean</code></td><td>A checkbox; renders as Yes/No when read-only. No settings.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000003</code></td></tr><tr><td>Date</td><td><code dir="auto">com.velora.date</code>, stores a <code dir="auto">string</code> (<code dir="auto">format: date</code>)</td><td>A native date input, storing the <code dir="auto">YYYY-MM-DD</code> string it produces. No settings.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000004</code></td></tr><tr><td>Image</td><td><code dir="auto">com.velora.image</code>, stores a <code dir="auto">string</code></td><td>A <strong>media reference id</strong>, not the file itself. The Media Library item is fetched separately by that id. Settings: <code dir="auto">acceptedTypes</code>, <code dir="auto">maxSizeBytes</code>.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000005</code></td></tr><tr><td>Rich Text</td><td><code dir="auto">com.velora.richtext</code>, stores an <code dir="auto">object</code></td><td>The rich-text editor’s native JSON document shape — a nested object, not an HTML string. No settings.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000006</code></td></tr></tbody></table>
+<p>Only Text and Image validate their <code dir="auto">settings</code> object server-side today —
+number, boolean, date, and rich text accept whatever <code dir="auto">settings</code> you send
+because they have nothing to configure. These are distinct from a field’s
+own <code dir="auto">validation.maxLength</code> (a save-time content rule, see the Fields
+section above): a Data Type’s <code dir="auto">maxLength</code> physically blocks typing in the
+browser instead.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">placeholder</code></td><td>string, optional</td><td>Placeholder text shown in an empty Text input.</td><td><code dir="auto">"Enter a title…"</code></td></tr><tr><td><code dir="auto">maxLength</code></td><td>integer ≥ 1, optional</td><td>Text editor only: hard character cap enforced in the browser input itself.</td><td><code dir="auto">200</code></td></tr><tr><td><code dir="auto">acceptedTypes</code></td><td>array of string, optional</td><td>Image editor only: MIME types the media picker offers for this field.</td><td><code dir="auto">["image/png", "image/jpeg"]</code></td></tr><tr><td><code dir="auto">maxSizeBytes</code></td><td>integer ≥ 1, optional</td><td>Image editor only: largest file the media picker accepts for this field.</td><td><code dir="auto">5242880</code></td></tr></tbody></table>
+<p>New editors come from plugins: install a datatype plugin, then create Data
+Type configurations of it exactly as you would for a built-in. Writing one
+is covered in
+<a href="https://docs.velora-cms.com/v1/building-plugins/datatype-plugin-contract/">Building plugins</a>.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="tree-rules">Tree rules</h2><a class="sl-anchor-link" href="#tree-rules"><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 “Tree rules”</span></a></div>
+<p><code dir="auto">treeRules</code> exist on <code dir="auto">page</code> types only, and they answer three questions:
+may this type exist at the root of the tree, which parent types may it be
+created under, and which types may be created under it.</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">allowedAtRoot</code></td><td>boolean, required</td><td>Whether content of this type may be created with <code dir="auto">parentId: null</code>. <code dir="auto">false</code> means it only ever exists under a parent.</td><td><code dir="auto">true</code></td></tr><tr><td><code dir="auto">allowedParentTypes</code></td><td>array of document type ids, required</td><td>Which types this one may be created under. <strong>An empty array means “any page type”</strong>, not “none”.</td><td><code dir="auto">[]</code></td></tr><tr><td><code dir="auto">allowedChildTypes</code></td><td>array of document type ids, required</td><td>Which types may be created under content of this type. Empty likewise means any page type.</td><td><code dir="auto">["b8e4c0f1-2d63-4a95-8e07-31f9a5c2d648"]</code></td></tr></tbody></table>
+<p>All three keys are required whenever <code dir="auto">treeRules</code> is present, and the whole
+object is required when updating a <code dir="auto">page</code> type — the update schema cannot
+see the stored <code dir="auto">kind</code>, so the route enforces the pairing itself: a <code dir="auto">page</code>
+update without <code dir="auto">treeRules</code> is a <code dir="auto">400</code>, and an <code dir="auto">element</code> update carrying
+<code dir="auto">treeRules</code> is also a <code dir="auto">400</code>.</p>
+<p>The rules are enforced in two places that agree by construction. The
+tree’s per-node create menu offers exactly the types the rules permit, and
+the server re-checks the same rules when content is created — rejecting a
+placement with one of <code dir="auto">not-allowed-at-root</code>, <code dir="auto">parent-forbids-child-type</code>,
+or <code dir="auto">child-forbids-parent-type</code>. Creation is the only enforcement point
+that exists, because there is no move or reparent endpoint in v1.</p>
+<div class="sl-heading-wrapper level-h3"><h3 id="reserved-root-slugs">Reserved root slugs</h3><a class="sl-anchor-link" href="#reserved-root-slugs"><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 “Reserved root slugs”</span></a></div>
+<p>A handful of root-level paths belong to the server itself, not to
+content, because they are already routes: <code dir="auto">/velora</code> is the admin UI,
+<code dir="auto">/api</code> is the whole API surface, <code dir="auto">/docs</code> is the bundled documentation, and
+<code dir="auto">/plugin-assets</code> serves plugin-contributed static files. Creating a
+root-level (<code dir="auto">parentId: null</code>) page whose first path segment is one of
+these — regardless of case — is rejected on top of the tree-rules check
+above, whether or not <code dir="auto">treeRules.allowedAtRoot</code> permits the type at the
+root:</p>
+<table><thead><tr><th>Reserved root slug</th><th>Namespace</th></tr></thead><tbody><tr><td><code dir="auto">velora</code></td><td>The admin SPA</td></tr><tr><td><code dir="auto">api</code></td><td>The whole API surface (<code dir="auto">/api/*</code>)</td></tr><tr><td><code dir="auto">docs</code></td><td>The bundled documentation</td></tr><tr><td><code dir="auto">plugin-assets</code></td><td>Plugin-contributed static files</td></tr></tbody></table>
+<p>The rejection is a <code dir="auto">400</code> shaped like any other field validation failure —
+see <a href="/docs/v1/using-velora/editing/">Content editing</a> for the full
+<code dir="auto">fieldErrors</code> shape — with exactly one entry:
+<code dir="auto">fieldErrors[0].fieldId</code> is <code dir="auto">"slug"</code> and <code dir="auto">fieldErrors[0].key</code> is
+<code dir="auto">"contentCreate.errors.reservedSlug"</code>. The check only ever looks at a
+root-level item’s first path segment, so a reserved word deeper in the
+tree (<code dir="auto">/blog/api</code>, say) is unaffected.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="locales">Locales</h2><a class="sl-anchor-link" href="#locales"><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 “Locales”</span></a></div>
+<p>Locale is a property of a <em>content item</em>, not of a document type — one
+type serves every language. Translations are separate content nodes
+sharing a <code dir="auto">translationGroupId</code>, one of which carries
+<code dir="auto">isDefaultLocale: true</code>. The admin’s create form always writes
+<code dir="auto">locale: "en"</code> with <code dir="auto">isDefaultLocale: true</code> today; additional translations
+are created over the API by posting another node with the same
+<code dir="auto">translationGroupId</code>. Reading one is a query parameter away —
+<code dir="auto">GET /api/content/:id?locale=fr&#x26;fallback=en</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">locale</code></td><td>string, at least 2 characters, optional</td><td>The translation to fetch instead of this node’s own locale. Omit it and the node is returned as-is, with <code dir="auto">fallback</code> ignored entirely.</td><td><code dir="auto">fr</code></td></tr><tr><td><code dir="auto">fallback</code></td><td>string, at least 2 characters, optional</td><td>An explicit fallback locale to serve when <code dir="auto">locale</code> has no matching translation. Omit it and an unmatched <code dir="auto">locale</code> is a plain <code dir="auto">404</code> — explicit means explicit, there is no automatic default-locale fallback here.</td><td><code dir="auto">en</code></td></tr></tbody></table>
+<p>See <a href="/docs/v1/using-velora/editing/">Content editing</a> for how the node this
+route returns relates to its versions.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="templates-are-inert-in-v1">Templates are inert in v1</h2><a class="sl-anchor-link" href="#templates-are-inert-in-v1"><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 are inert in v1”</span></a></div>
+<p>A page type can point at a <code dir="auto">TemplateDefinition</code> — a named record tying a
+template to a document type, with many templates able to target one type:</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 record’s identity; what <code dir="auto">defaultTemplateId</code> points at.</td><td><code dir="auto">3d9c81e2-5b47-4a10-9f6d-08c2a7b31f45</code></td></tr><tr><td><code dir="auto">name</code></td><td>string, non-empty</td><td>Display name in the document type editor’s Templates tab.</td><td><code dir="auto">Wide page</code></td></tr><tr><td><code dir="auto">documentTypeId</code></td><td>string (uuid)</td><td>The <code dir="auto">page</code> type this template targets.</td><td><code dir="auto">7a2f1c40-9b31-4d6a-8f0e-2c5b7d1a4e93</code></td></tr></tbody></table>
+<p>In v1 that is all a template is: an inert data record. There is no
+rendering engine consuming it, and no “preview the rendered page” button,
+because Velora v1 is headless-first — you build the site with the
+REST/GraphQL API and your own frontend. The default-template pointer is
+backoffice-only: the public document type shape and the public templates
+list both omit <code dir="auto">defaultTemplateId</code>, so a frontend can list a type’s
+templates but cannot learn which one is marked default. Template rendering
+is planned as a later release, not a v1 feature.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="a-worked-example-a-page-type-in-the-admin">A worked example: a Page type in the admin</h2><a class="sl-anchor-link" href="#a-worked-example-a-page-type-in-the-admin"><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 “A worked example: a Page type in the admin”</span></a></div>
+<p>The steps below create a <code dir="auto">Page</code> type with two fields, <code dir="auto">title</code> (Text) and
+<code dir="auto">body</code> (Rich Text), allowed at the root of the tree.</p>
+<ol>
+<li>Go to <strong>Settings → Document Types</strong> and use the <strong>+</strong> button to open
+<strong>New document type</strong>.</li>
+<li>Fill in <strong>Name</strong> (<code dir="auto">Page</code>) and <strong>Icon</strong> (<code dir="auto">file-text</code>). Both are
+required — the save button stays disabled until they are set.</li>
+<li>Leave <strong>Kind</strong> on <strong>Page</strong>.</li>
+<li>Select <strong>Add field</strong>. Set <strong>Key</strong> to <code dir="auto">title</code>, <strong>Label</strong> to <code dir="auto">Title</code>,
+and <strong>Datatype</strong> to <strong>Text</strong>. Under <strong>Validation rules</strong>, tick
+<strong>Required</strong> and set <strong>Max length</strong> to <code dir="auto">120</code>.</li>
+<li>Select <strong>Add field</strong> again. Set <strong>Key</strong> to <code dir="auto">body</code>, <strong>Label</strong> to
+<code dir="auto">Body</code>, and <strong>Datatype</strong> to <strong>Rich Text</strong>.</li>
+<li>Leave <strong>Tabs</strong> empty — two fields do not need grouping, and the editor
+renders them under a single <strong>Content</strong> tab.</li>
+<li>Tick <strong>Allowed at root</strong>, and leave <strong>Allowed parent types</strong> and
+<strong>Allowed child types</strong> empty (empty means any type).</li>
+<li>Select <strong>Save</strong>.</li>
+</ol>
+<p>The type appears in the Settings tree, and the content tree’s <strong>+</strong> button
+now offers <strong>Page</strong> at the root.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="the-same-thing-over-the-admin-api">The same thing over the admin API</h2><a class="sl-anchor-link" href="#the-same-thing-over-the-admin-api"><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 same thing over the admin API”</span></a></div>
+<p>Everything the builder does is an ordinary API call, which is how a
+provisioning script or a migration would do it. The JSON in this section
+is derived from the Zod schemas in <code dir="auto">packages/api-schemas</code> and the shapes
+the route tests assert — it is not a captured transcript, so ids and
+timestamps are illustrative.</p>
+<p>Writes need a signed-in session token — any authenticated user, admin or
+editor, since document type routes only require a session, not the admin
+role — so sign in first:</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:#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/auth/login</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">{"email":"you@example.com","password":"correct-horse-8"}</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/auth/login \  -H &#x22;Content-Type: application/json&#x22; \  -d &#x27;{&#x22;email&#x22;:&#x22;you@example.com&#x22;,&#x22;password&#x22;:&#x22;correct-horse-8&#x22;}&#x27;"><div></div></button></div></figure></div>
+<p>The response carries the access token — good for 15 minutes — and the
+signed-in user; a refresh cookie rides along in the <code dir="auto">Set-Cookie</code> header:</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">"accessToken"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…</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">"user"</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">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">0b6d4e21-8c3a-4f57-9d02-6a1e5b7c8d90</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">"email"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">you@example.com</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">"name"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Ada Lovelace</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">"role"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">admin</span><span style="--0:#D9F5DD;--1:#111111">"</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">  </span></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;accessToken&#x22;: &#x22;eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…&#x22;,  &#x22;user&#x22;: {    &#x22;id&#x22;: &#x22;0b6d4e21-8c3a-4f57-9d02-6a1e5b7c8d90&#x22;,    &#x22;email&#x22;: &#x22;you@example.com&#x22;,    &#x22;name&#x22;: &#x22;Ada Lovelace&#x22;,    &#x22;role&#x22;: &#x22;admin&#x22;  }}"><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">email</code></td><td>string (email), required</td><td>Request only: the account’s email.</td><td><code dir="auto">you@example.com</code></td></tr><tr><td><code dir="auto">password</code></td><td>string, non-empty, required</td><td>Request only.</td><td><code dir="auto">correct-horse-8</code></td></tr><tr><td><code dir="auto">accessToken</code></td><td>string</td><td>Response only: a JWT, good for 15 minutes, sent as <code dir="auto">Authorization: Bearer &#x3C;accessToken></code> on every write below.</td><td><code dir="auto">eyJhbGciOiJIUzI1NiIs…</code></td></tr><tr><td><code dir="auto">user.id</code></td><td>string (uuid)</td><td>Response only: the signed-in user’s id.</td><td><code dir="auto">0b6d4e21-8c3a-4f57-9d02-6a1e5b7c8d90</code></td></tr><tr><td><code dir="auto">user.email</code></td><td>string (email)</td><td>Response only.</td><td><code dir="auto">you@example.com</code></td></tr><tr><td><code dir="auto">user.name</code></td><td>string or <code dir="auto">null</code></td><td>Response only.</td><td><code dir="auto">Ada Lovelace</code></td></tr><tr><td><code dir="auto">user.role</code></td><td><code dir="auto">"admin"</code> | <code dir="auto">"editor"</code></td><td>Response only: determines which routes accept this token — see the write note above.</td><td><code dir="auto">admin</code></td></tr></tbody></table>
+<p>A refresh token rides along in an <code dir="auto">httpOnly</code> <code dir="auto">Set-Cookie</code>, never in the
+response body — the JS client can never read it.</p>
+<p>Next, find the Data Type ids the fields will reference. This read needs no
+token — the document type and data type list routes are unauthenticated on
+the admin origin:</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">http://localhost:3000/api/data-types?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 &#x22;http://localhost:3000/api/data-types?limit=2&#x22;"><div></div></button></div></figure></div>
+<p>It answers a cursor-paginated page of configurations — on a fresh
+instance, the six seeded built-ins, ordered by name:</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">"items"</span><span style="--0:#D6DEEB;--1:#403F53">: [</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">    </span></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">b1e00000-0000-4000-8000-000000000003</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">Boolean</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"editorId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">com.velora.boolean</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"settings"</span><span style="--0:#D6DEEB;--1:#403F53">: {} },</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">    </span></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">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">"name"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">Date</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"editorId"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">com.velora.date</span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#D6DEEB;--1:#403F53">, </span><span style="--0:#7FDBCA;--1:#096E72">"settings"</span><span style="--0:#D6DEEB;--1:#403F53">: {} }</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">  </span></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">"nextCursor"</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></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;items&#x22;: [    { &#x22;id&#x22;: &#x22;b1e00000-0000-4000-8000-000000000003&#x22;, &#x22;name&#x22;: &#x22;Boolean&#x22;, &#x22;editorId&#x22;: &#x22;com.velora.boolean&#x22;, &#x22;settings&#x22;: {} },    { &#x22;id&#x22;: &#x22;b1e00000-0000-4000-8000-000000000004&#x22;, &#x22;name&#x22;: &#x22;Date&#x22;, &#x22;editorId&#x22;: &#x22;com.velora.date&#x22;, &#x22;settings&#x22;: {} }  ],  &#x22;nextCursor&#x22;: &#x22;b1e00000-0000-4000-8000-000000000004&#x22;}"><div></div></button></div></figure></div>
+<p>The same three pagination parameters appear on every list route in this
+section:</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, default <code dir="auto">50</code></td><td>Page size, coerced from the query string. Outside the range is a <code dir="auto">400</code>.</td><td><code dir="auto">2</code></td></tr><tr><td><code dir="auto">cursor</code></td><td>string (uuid), optional</td><td>The <code dir="auto">id</code> of the previous page’s last row. Omit it for the first page.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000004</code></td></tr><tr><td><code dir="auto">nextCursor</code></td><td>string (uuid) or <code dir="auto">null</code></td><td>Feed it back as <code dir="auto">cursor</code> for the next page. <code dir="auto">null</code> means this was the last page.</td><td><code dir="auto">null</code></td></tr></tbody></table>
+<p>Now create the type. <code dir="auto">POST /api/document-types</code> takes the same shape as
+the definition above <strong>minus <code dir="auto">id</code></strong> — the server mints that — and minus
+<code dir="auto">defaultTemplateId</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">-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/document-types</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">-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">$TOKEN</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">"name": "Page",</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">"icon": "file-text",</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">"kind": "page",</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">"fields": [</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></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">"id": "title",</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">"name": "Title",</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">"datatypeId": "b1e00000-0000-4000-8000-000000000001",</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">"validation": { "required": true, "maxLength": 120 }</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></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></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">"id": "body",</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">"name": "Body",</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">"datatypeId": "b1e00000-0000-4000-8000-000000000006"</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></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></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">"treeRules": { "allowedAtRoot": true, "allowedParentTypes": [], "allowedChildTypes": [] },</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">"tabs": []</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/document-types \  -H &#x22;Content-Type: application/json&#x22; \  -H &#x22;Authorization: Bearer $TOKEN&#x22; \  -d &#x27;{    &#x22;name&#x22;: &#x22;Page&#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;maxLength&#x22;: 120 }      },      {        &#x22;id&#x22;: &#x22;body&#x22;,        &#x22;name&#x22;: &#x22;Body&#x22;,        &#x22;datatypeId&#x22;: &#x22;b1e00000-0000-4000-8000-000000000006&#x22;      }    ],    &#x22;treeRules&#x22;: { &#x22;allowedAtRoot&#x22;: true, &#x22;allowedParentTypes&#x22;: [], &#x22;allowedChildTypes&#x22;: [] },    &#x22;tabs&#x22;: []  }&#x27;"><div></div></button></div></figure></div>
+<p>A success is <code dir="auto">201</code> carrying the stored definition, including the id the
+server minted for it:</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">"documentType"</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">"id"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#D9F5DD;--1:#111111">"</span><span style="--0:#C789D6;--1:#7C5686">7a2f1c40-9b31-4d6a-8f0e-2c5b7d1a4e93</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">"name"</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></div></div><div class="ec-line"><div class="code"><span class="indent">    </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></div></div><div class="ec-line"><div class="code"><span class="indent">    </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></div></div><div class="ec-line"><div class="code"><span class="indent">    </span><span style="--0:#7FDBCA;--1:#096E72">"fields"</span><span style="--0:#D6DEEB;--1:#403F53">: [</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">      </span></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">"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></div></div><div class="ec-line"><div class="code"><span class="indent">        </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></div></div><div class="ec-line"><div class="code"><span class="indent">        </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></div></div><div class="ec-line"><div class="code"><span class="indent">        </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">"maxLength"</span><span style="--0:#D6DEEB;--1:#403F53">: </span><span style="--0:#F78C6C;--1:#AA0982">120</span><span style="--0:#D6DEEB;--1:#403F53"> }</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">      </span></span><span style="--0:#D6DEEB;--1:#403F53">},</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">      </span></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></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">    </span></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">"treeRules"</span><span style="--0:#D6DEEB;--1:#403F53">: { </span><span style="--0:#7FDBCA;--1:#096E72">"allowedAtRoot"</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">"allowedParentTypes"</span><span style="--0:#D6DEEB;--1:#403F53">: [], </span><span style="--0:#7FDBCA;--1:#096E72">"allowedChildTypes"</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">"tabs"</span><span style="--0:#D6DEEB;--1:#403F53">: []</span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#D6DEEB;--1:#403F53">  </span></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;documentType&#x22;: {    &#x22;id&#x22;: &#x22;7a2f1c40-9b31-4d6a-8f0e-2c5b7d1a4e93&#x22;,    &#x22;name&#x22;: &#x22;Page&#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;maxLength&#x22;: 120 }      },      { &#x22;id&#x22;: &#x22;body&#x22;, &#x22;name&#x22;: &#x22;Body&#x22;, &#x22;datatypeId&#x22;: &#x22;b1e00000-0000-4000-8000-000000000006&#x22; }    ],    &#x22;treeRules&#x22;: { &#x22;allowedAtRoot&#x22;: true, &#x22;allowedParentTypes&#x22;: [], &#x22;allowedChildTypes&#x22;: [] },    &#x22;tabs&#x22;: []  }}"><div></div></button></div></figure></div>
+<p>Keep the returned <code dir="auto">id</code> — it is what <code dir="auto">POST /api/content</code> needs as
+<code dir="auto">documentTypeId</code> when you create your first item.</p>
+<p>The rest of the resource follows the same shapes:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td><code dir="auto">GET /api/document-types</code></td><td>route</td><td>Cursor-paginated list, <code dir="auto">{ items, nextCursor }</code>. No token required.</td><td><code dir="auto">?limit=50</code></td></tr><tr><td><code dir="auto">POST /api/document-types</code></td><td>route</td><td>Create. <code dir="auto">201</code> with <code dir="auto">{ documentType }</code>; <code dir="auto">400</code> when a <code dir="auto">datatypeId</code> matches no data type row.</td><td>—</td></tr><tr><td><code dir="auto">PUT /api/document-types/:id</code></td><td>route</td><td>Full replace of the mutable definition: <code dir="auto">name</code>, <code dir="auto">icon</code>, <code dir="auto">fields</code>, <code dir="auto">tabs</code>, <code dir="auto">treeRules</code>. <code dir="auto">kind</code> and <code dir="auto">defaultTemplateId</code> are not accepted here.</td><td>—</td></tr><tr><td><code dir="auto">PATCH /api/document-types/:id/default-template</code></td><td>route</td><td>Sets or clears the default template pointer. Body <code dir="auto">{ "templateId": … }</code>, nullable.</td><td><code dir="auto">{"templateId":null}</code></td></tr><tr><td><code dir="auto">DELETE /api/document-types/:id</code></td><td>route</td><td>Deletes the type. <code dir="auto">409</code> if any live content or any template still references it — no cascade, by design.</td><td>—</td></tr></tbody></table>
+<p>Deleting a type is the one place content is genuinely destroyed: the
+delete first purges content of that type <strong>already sitting in the trash</strong>,
+then removes the type row. Live content blocks the delete outright, with a
+message naming how many items are in the way.</p>
+<div class="sl-heading-wrapper level-h2"><h2 id="how-ids-are-minted">How ids are minted</h2><a class="sl-anchor-link" href="#how-ids-are-minted"><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 “How ids are minted”</span></a></div>
+<p>Four different id conventions live in this model, and mixing them up is
+the usual first mistake:</p>
+<table><thead><tr><th>Name</th><th>Type</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>Document type <code dir="auto">id</code></td><td>uuid, minted by the server</td><td>Generated when the type is created, by the same service the admin route and the plugin installer both call. Never supplied by the caller.</td><td><code dir="auto">7a2f1c40-9b31-4d6a-8f0e-2c5b7d1a4e93</code></td></tr><tr><td>Field <code dir="auto">id</code></td><td>a key <strong>you</strong> choose</td><td>Human-typed and stable: it becomes the key in stored content data. Constrained to <code dir="auto">^[a-zA-Z][a-zA-Z0-9_]*$</code>, not a uuid.</td><td><code dir="auto">title</code></td></tr><tr><td>Tab <code dir="auto">id</code></td><td>uuid, minted by the builder</td><td>Generated in the browser when you add a tab. Never a data key — only a field’s <code dir="auto">tabId</code> refers to it.</td><td><code dir="auto">9c1e5b70-4a62-4f83-b0d1-7e2f6a48c531</code></td></tr><tr><td><code dir="auto">datatypeId</code></td><td>uuid of a Data Type configuration</td><td>Points at a row in the data types table, <em>not</em> at an editor id such as <code dir="auto">com.velora.text</code>. An id with no matching row is a <code dir="auto">400</code>.</td><td><code dir="auto">b1e00000-0000-4000-8000-000000000001</code></td></tr></tbody></table>
+<p>Plugins can ship document types too. A <code dir="auto">section</code> or <code dir="auto">template</code> plugin
+declares them in its manifest, and the installer creates them through the
+exact same service the admin route uses — so ids are server-minted there
+as well. Because a manifest cannot know an id that does not exist yet, a
+plugin’s <code dir="auto">treeRules</code> reference its <strong>own</strong> types by <em>name</em>, and the
+installer resolves those names to minted ids in a second pass. A name that
+is not one of that plugin’s declared types fails the install and rolls
+back every type it had created.</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/editing/">Content editing</a> — creating items of these
+types, and what Save, Publish, and rollback actually write.</li>
+<li><a href="/docs/v1/using-velora/headless-api/">Headless API</a> — reading document types
+and content back out, including the narrower public shape.</li>
+<li><a href="/docs/v1/using-velora/media/">Media</a> — where the id an Image field stores
+comes from.</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/installation/" 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">Installation</span></span></a><a href="/docs/v1/using-velora/editing/" 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">Content editing</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>