Moab logoMoab
Get started
Moab Docs

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 pages
data_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

ParameterTypeKindDescription
statusstringfilterThe 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.
originstringfilterWhere 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_idstringfilterThe campaign agent this page belongs to — the lineage the funnel evidence groups by.
variant_ofstringfilterExperiment 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.
qstringsearchFree-text search across name, slug.
sortstringsortOne of score, status; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_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

ParameterTypeKindDescription
idstringpathThe 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 campaign
data_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

FieldTypeRequiredDescription
namestringnoHuman-readable page name.
statusstringnoThe 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.
slugstringnoURL 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.
originstringnoWhere 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_urlstringnoindexed/kit only: the URL this page was indexed or imported from. Immutable.
blocksobjectnoThe 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).
hypothesisstringnoWhy 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'.
scoreobjectnoThe 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.totalnumbernoSum of components[].points — server-computed at the write door.
  score.componentsarraynoThe score's ledger — [{ id, kind: best_practices|engagement, points, note, counts? }].
agent_idstringnoThe 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} live
data_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

FieldTypeRequiredDescription
namestringnoHuman-readable page name.
statusstringnoThe 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.
slugstringnoURL 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.
originstringnoWhere 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_urlstringnoindexed/kit only: the URL this page was indexed or imported from. Immutable.
blocksobjectnoThe 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).
hypothesisstringnoWhy 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'.
scoreobjectnoThe 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.totalnumbernoSum of components[].points — server-computed at the write door.
  score.componentsarraynoThe score's ledger — [{ id, kind: best_practices|engagement, points, note, counts? }].
agent_idstringnoThe 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

FieldTypeRequiredDescription
eventstringyesThe human-readable timeline entry.
contextobjectnoProvenance — 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.

FieldTypeDescription
objectstringAlways page.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
page_urlstringThe served URL — server-stamped when hosting serves the page (never model-written; refused page_url_server_stamped).
template_idstringThe 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_ofstringExperiment 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_modelstringThe 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.

On this page

Moab logoMoab

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans