Pages
Landing pages — indexed from the customer's site, or built from typed blocks, scored by the same engagement stamp as content.
Base path /api/v1/pages on https://moabcrm.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.
List pages
GET /api/v1/pages
curl "https://moabcrm.com/api/v1/pages?status=sandbox" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest"Show me the live pagesdata_query {
"collection": "pages",
"where": {
"status": "sandbox"
}
}Returns a paginated list of page objects, newest first.
{
"object": "list",
"data": [
{
"object": "page",
"id": "obj_123",
"name": "Spring Launch",
"status": "live",
"slug": "spring-launch",
"origin": "built",
"source_url": "source url",
"blocks": {
"version": 1,
"root": {
"props": {
"seo": {
"title": "Spring Launch",
"og_image": "auto"
}
}
},
"content": [
{
"type": "Hero",
"props": {
"id": "hero-1",
"headline": "Ship health you can see",
"variant": "capture-first",
"capture": {
"button_label": "Try for free"
}
}
},
{
"type": "Footer",
"props": {
"id": "footer-1",
"brand_name": "Acme"
}
}
]
},
"page_url": "https://zest.pages.moabcrm.com/spring-launch",
"score": {
"total": 8,
"components": [
{
"id": "best_practices",
"kind": "best_practices",
"points": 3,
"note": "+ one-clear-cta, capture-above-fold, headline-matches-promise"
},
{
"id": "engagement",
"kind": "engagement",
"points": 5,
"note": "0 opened · 0 clicked · 1 signups"
}
]
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}Parameters
| Parameter | Type | Kind | Description |
|---|---|---|---|
status | string | filter | The one lifecycle ladder (supply-truth §10): sandbox (built, awaiting Approve — never publicly served), live (autohosted and serving), or archived (the one terminal state — culled experiment arms land here). One of sandbox, live, archived. |
origin | string | filter | Where the page came from — immutable after create. indexed: a live page on the customer's own site (source_url is the real URL); built: composed from typed blocks by a build run; kit: an imported block kit (never served — the worker refuses kit pages by name; its blocks ARE the library entries). One of indexed, built, kit. |
agent_id | string | filter | The campaign agent this page belongs to — the lineage the funnel evidence groups by. |
variant_of | string | filter | Experiment parent — this page competes with that page for the SAME audience. Must reference an existing page. A page has at most one of template_id/variant_of each. |
q | string | search | Free-text search across name, slug. |
sort | string | sort | One of score, status; prefix with - to reverse. |
limit | number | page | Rows to return, 1–100. Defaults to 20. |
cursor | string | page | next_cursor from the previous page. |
Retrieve a page
GET /api/v1/pages/draft-001
curl "https://moabcrm.com/api/v1/pages/draft-001" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest"Open the page {id}data_get {
"collection": "pages",
"object_id": "draft-001"
}Returns the page object.
{
"object": "page",
"id": "obj_123",
"name": "Spring Launch",
"status": "live",
"slug": "spring-launch",
"origin": "built",
"source_url": "source url",
"blocks": {
"version": 1,
"root": {
"props": {
"seo": {
"title": "Spring Launch",
"og_image": "auto"
}
}
},
"content": [
{
"type": "Hero",
"props": {
"id": "hero-1",
"headline": "Ship health you can see",
"variant": "capture-first",
"capture": {
"button_label": "Try for free"
}
}
},
{
"type": "Footer",
"props": {
"id": "footer-1",
"brand_name": "Acme"
}
}
]
},
"page_url": "https://zest.pages.moabcrm.com/spring-launch",
"score": {
"total": 8,
"components": [
{
"id": "best_practices",
"kind": "best_practices",
"points": 3,
"note": "+ one-clear-cta, capture-above-fold, headline-matches-promise"
},
{
"id": "engagement",
"kind": "engagement",
"points": 5,
"note": "0 opened · 0 clicked · 1 signups"
}
]
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Parameter | Type | Kind | Description |
|---|---|---|---|
id | string | path | The page's id or slug. |
Create a page
POST /api/v1/pages
curl -X POST "https://moabcrm.com/api/v1/pages" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"name":"Spring Launch","origin":"built","agent_id":"agent-yc-ctos","slug":"spring-launch","hypothesis":"urgency framing beats social proof","blocks":{"version":1,"root":{"props":{"seo":{"title":"Spring Launch","og_image":"auto"}}},"content":[{"type":"Hero","props":{"id":"hero-1","headline":"Ship health you can see","variant":"capture-first","capture":{"button_label":"Try for free"}}},{"type":"Footer","props":{"id":"footer-1","brand_name":"Acme"}}]}}'Build a landing page for the YC campaigndata_set {
"collection": "pages",
"object_id": "draft-001",
"data": {
"name": "Spring Launch",
"origin": "built",
"agent_id": "agent-yc-ctos",
"slug": "spring-launch",
"hypothesis": "urgency framing beats social proof",
"blocks": {
"version": 1,
"root": {
"props": {
"seo": {
"title": "Spring Launch",
"og_image": "auto"
}
}
},
"content": [
{
"type": "Hero",
"props": {
"id": "hero-1",
"headline": "Ship health you can see",
"variant": "capture-first",
"capture": {
"button_label": "Try for free"
}
}
},
{
"type": "Footer",
"props": {
"id": "footer-1",
"brand_name": "Acme"
}
}
]
}
}
}Returns the page object.
{
"object": "page",
"id": "obj_123",
"name": "Spring Launch",
"status": "live",
"slug": "spring-launch",
"origin": "built",
"source_url": "source url",
"blocks": {
"version": 1,
"root": {
"props": {
"seo": {
"title": "Spring Launch",
"og_image": "auto"
}
}
},
"content": [
{
"type": "Hero",
"props": {
"id": "hero-1",
"headline": "Ship health you can see",
"variant": "capture-first",
"capture": {
"button_label": "Try for free"
}
}
},
{
"type": "Footer",
"props": {
"id": "footer-1",
"brand_name": "Acme"
}
}
]
},
"page_url": "https://zest.pages.moabcrm.com/spring-launch",
"score": {
"total": 8,
"components": [
{
"id": "best_practices",
"kind": "best_practices",
"points": 3,
"note": "+ one-clear-cta, capture-above-fold, headline-matches-promise"
},
{
"id": "engagement",
"kind": "engagement",
"points": 5,
"note": "0 opened · 0 clicked · 1 signups"
}
]
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | Human-readable page name. |
status | string | no | The one lifecycle ladder (supply-truth §10): sandbox (built, awaiting Approve — never publicly served), live (autohosted and serving), or archived (the one terminal state — culled experiment arms land here). One of sandbox, live, archived. |
slug | string | no | URL path on the pages host — kebab-case, unique per project (the door normalizes; for-yc style for audience campaign pages, also served at /for/yc). Renaming a live page's slug breaks inbound links; prefer new pages. |
origin | string | no | Where the page came from — immutable after create. indexed: a live page on the customer's own site (source_url is the real URL); built: composed from typed blocks by a build run; kit: an imported block kit (never served — the worker refuses kit pages by name; its blocks ARE the library entries). One of indexed, built, kit. |
source_url | string | no | indexed/kit only: the URL this page was indexed or imported from. Immutable. |
blocks | object | no | The page document — Puck-shaped { version: 1, root: { props: { seo, theme } }, content: [{ type, props }] } over the closed 13-type registry. Validated whole at the write door (page_blocks_invalid names the first offending block). |
hypothesis | string | no | Why this variant exists, written FROM the data (Coframe provenance): e.g. 'urgency framing beat social proof 4/28 vs 1/33 — push urgency harder in the hero'. |
score | object | no | The record's grade — { total, components }. IDENTICAL shape and components as agents/content: best_practices (the page best-practices rules) + engagement (server-stamped: visits ×1 · link clicks ×2 · signups ×5). The write door folds components and computes total; a model write carrying engagement has that component ignored (the server stamp wins). |
score.total | number | no | Sum of components[].points — server-computed at the write door. |
score.components | array | no | The score's ledger — [{ id, kind: best_practices|engagement, points, note, counts? }]. |
agent_id | string | no | The campaign agent this page belongs to — the lineage the funnel evidence groups by. |
Update a page
PATCH /api/v1/pages/draft-001
curl -X PATCH "https://moabcrm.com/api/v1/pages/draft-001" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"status":"sandbox","origin":"indexed"}'Set page {id} livedata_set {
"collection": "pages",
"object_id": "draft-001",
"data": {
"status": "sandbox",
"origin": "indexed"
}
}Returns the page object.
{
"object": "page",
"id": "obj_123",
"name": "Spring Launch",
"status": "live",
"slug": "spring-launch",
"origin": "built",
"source_url": "source url",
"blocks": {
"version": 1,
"root": {
"props": {
"seo": {
"title": "Spring Launch",
"og_image": "auto"
}
}
},
"content": [
{
"type": "Hero",
"props": {
"id": "hero-1",
"headline": "Ship health you can see",
"variant": "capture-first",
"capture": {
"button_label": "Try for free"
}
}
},
{
"type": "Footer",
"props": {
"id": "footer-1",
"brand_name": "Acme"
}
}
]
},
"page_url": "https://zest.pages.moabcrm.com/spring-launch",
"score": {
"total": 8,
"components": [
{
"id": "best_practices",
"kind": "best_practices",
"points": 3,
"note": "+ one-clear-cta, capture-above-fold, headline-matches-promise"
},
{
"id": "engagement",
"kind": "engagement",
"points": 5,
"note": "0 opened · 0 clicked · 1 signups"
}
]
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | Human-readable page name. |
status | string | no | The one lifecycle ladder (supply-truth §10): sandbox (built, awaiting Approve — never publicly served), live (autohosted and serving), or archived (the one terminal state — culled experiment arms land here). One of sandbox, live, archived. |
slug | string | no | URL path on the pages host — kebab-case, unique per project (the door normalizes; for-yc style for audience campaign pages, also served at /for/yc). Renaming a live page's slug breaks inbound links; prefer new pages. |
origin | string | no | Where the page came from — immutable after create. indexed: a live page on the customer's own site (source_url is the real URL); built: composed from typed blocks by a build run; kit: an imported block kit (never served — the worker refuses kit pages by name; its blocks ARE the library entries). One of indexed, built, kit. |
source_url | string | no | indexed/kit only: the URL this page was indexed or imported from. Immutable. |
blocks | object | no | The page document — Puck-shaped { version: 1, root: { props: { seo, theme } }, content: [{ type, props }] } over the closed 13-type registry. Validated whole at the write door (page_blocks_invalid names the first offending block). |
hypothesis | string | no | Why this variant exists, written FROM the data (Coframe provenance): e.g. 'urgency framing beat social proof 4/28 vs 1/33 — push urgency harder in the hero'. |
score | object | no | The record's grade — { total, components }. IDENTICAL shape and components as agents/content: best_practices (the page best-practices rules) + engagement (server-stamped: visits ×1 · link clicks ×2 · signups ×5). The write door folds components and computes total; a model write carrying engagement has that component ignored (the server stamp wins). |
score.total | number | no | Sum of components[].points — server-computed at the write door. |
score.components | array | no | The score's ledger — [{ id, kind: best_practices|engagement, points, note, counts? }]. |
agent_id | string | no | The campaign agent this page belongs to — the lineage the funnel evidence groups by. |
Append an event to a page
POST /api/v1/pages/{id}/events
curl -X POST "https://moabcrm.com/api/v1/pages/draft-001/events" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"event":"Noted by the operator","context":{"source":"api"}}'Add a note to the page {id}data_event {
"collection": "pages",
"object_id": "draft-001",
"event": "Noted by the operator"
}Returns the appended event object.
{
"object": "event",
"id": "evt_123",
"event": "Noted by the operator"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
event | string | yes | The human-readable timeline entry. |
context | object | no | Provenance — source, integration, worker_run_id, … |
What comes back (read-only)
Every page carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.
| Field | Type | Description |
|---|---|---|
object | string | Always page. |
id | string | Stable object id. Also accepted in place of slug on any path. |
slug | string | URL-safe name, unique within the collection. |
created_at | string | ISO-8601 timestamp of the first write. |
updated_at | string | ISO-8601 timestamp of the most recent write. The cursor sorts on this. |
page_url | string | The served URL — server-stamped when hosting serves the page (never model-written; refused page_url_server_stamped). |
template_id | string | The exemplar page this one was built FROM for a different audience (clone-and-swap — the YC page is the incubator template; HF0 stamps template_id = the YC page). Must reference an existing page. |
variant_of | string | Experiment parent — this page competes with that page for the SAME audience. Must reference an existing page. A page has at most one of template_id/variant_of each. |
build_model | string | The model that built this page — stamped by the build door from the run's backend, never model-written (model choice is an experiment axis; score by lineage answers which model builds pages that convert). |
Errors
Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.