@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/landingPages.md

@@ -0,0 +1,2488 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.landingPages`: Landing Pages
+
+59 operations (20 read, 21 write, 3 destructive, 13 billable, 2 external).
+
+No hand-written client covers this area. Call it through `g8.api.landingPages.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [landingPages.d.ts](landingPages.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`applyLandingPageReviewFindings`](#op-applylandingpagereviewfindings) | `POST /api/v1/landing-pages/{landing_page_id}/ai-review/apply` | write | `campaigns:write` | Apply Landing Page Review Findings |
+| [`approveLandingPageTemplate`](#op-approvelandingpagetemplate) | `PATCH /api/v1/landing-pages/{landing_page_id}/approve-template` | write | `campaigns:write` | Approve Landing Page Template |
+| [`clearLandingPageConsentOverride`](#op-clearlandingpageconsentoverride) | `DELETE /api/v1/landing-pages/{landing_page_id}/tracking/consent` | destructive | `campaigns:delete` | Clear Landing Page Consent Override |
+| [`cloneHomepageToLandingPage`](#op-clonehomepagetolandingpage) | `POST /api/v1/landing-pages/clone-homepage` | billable | `campaigns:run` | Clone Homepage To Landing Page |
+| [`cloneHtmlToLandingPage`](#op-clonehtmltolandingpage) | `POST /api/v1/landing-pages/clone-html` | billable | `campaigns:run` | Clone Html To Landing Page |
+| [`cloneUrlToLandingPage`](#op-cloneurltolandingpage) | `POST /api/v1/landing-pages/clone-url` | billable | `campaigns:run` | Clone Url To Landing Page |
+| [`convertLandingPageToFreeform`](#op-convertlandingpagetofreeform) | `POST /api/v1/landing-pages/{landing_page_id}/convert-to-freeform` | write | `campaigns:write` | Convert Landing Page To Freeform |
+| [`createLandingPage`](#op-createlandingpage) | `POST /api/v1/landing-pages` | billable | `campaigns:run` | Create Landing Page |
+| [`createLandingPageAgentSession`](#op-createlandingpageagentsession) | `POST /api/v1/landing-pages/{page_id}/agent-sessions` | write | `integrations:write` | Create Landing Page Agent Session |
+| [`createLandingPagePreviewLink`](#op-createlandingpagepreviewlink) | `GET /api/v1/landing-pages/{landing_page_id}/preview` | read | `campaigns:read` | Create Landing Page Preview Link |
+| [`deleteLandingPage`](#op-deletelandingpage) | `DELETE /api/v1/landing-pages/{landing_page_id}` | destructive | `campaigns:delete` | Delete Landing Page |
+| [`demoteLandingPageToTemplate`](#op-demotelandingpagetotemplate) | `POST /api/v1/landing-pages/{landing_page_id}/demote-to-template` | write | `campaigns:write` | Demote Landing Page To Template |
+| [`duplicateLandingPageTemplate`](#op-duplicatelandingpagetemplate) | `POST /api/v1/landing-pages/{landing_page_id}/duplicate` | write | `campaigns:write` | Duplicate Landing Page Template |
+| [`editLandingPageElement`](#op-editlandingpageelement) | `POST /api/v1/landing-pages/{landing_page_id}/edit-element` | billable | `campaigns:run` | Edit Landing Page Element |
+| [`editLandingPageWhole`](#op-editlandingpagewhole) | `POST /api/v1/landing-pages/{landing_page_id}/edit-page` | billable | `campaigns:run` | Edit Landing Page Whole |
+| [`editLandingPageWithChat`](#op-editlandingpagewithchat) | `POST /api/v1/landing-pages/{landing_page_id}/edit` | billable | `campaigns:run` | Edit Landing Page With Chat |
+| [`ensureLandingPageBaseTemplate`](#op-ensurelandingpagebasetemplate) | `POST /api/v1/landing-pages/ensure-base-template` | billable | `campaigns:run` | Ensure Landing Page Base Template |
+| [`exportLandingPage`](#op-exportlandingpage) | `GET /api/v1/landing-pages/{landing_page_id}/export` | read | `campaigns:read` | Export Landing Page |
+| [`extractLandingPageComponents`](#op-extractlandingpagecomponents) | `POST /api/v1/landing-pages/components/extract` | billable | `campaigns:run` | Extract Landing Page Components |
+| [`fixLandingPageFindingWithAi`](#op-fixlandingpagefindingwithai) | `POST /api/v1/landing-pages/{landing_page_id}/ai-review/fix-with-ai` | billable | `campaigns:run` | Fix Landing Page Finding With Ai |
+| [`generateLandingPageSeoMetadata`](#op-generatelandingpageseometadata) | `POST /api/v1/landing-pages/{landing_page_id}/generate-seo-metadata` | billable | `campaigns:run` | Generate Landing Page Seo Metadata |
+| [`getLandingPage`](#op-getlandingpage) | `GET /api/v1/landing-pages/{landing_page_id}` | read | `campaigns:read` | Get Landing Page |
+| [`getLandingPageConsentDefault`](#op-getlandingpageconsentdefault) | `GET /api/v1/landing-page-consent/default` | read | `campaigns:read` | Get Landing Page Consent Default |
+| [`getLandingPageConversation`](#op-getlandingpageconversation) | `GET /api/v1/landing-pages/{landing_page_id}/conversation` | read | `campaigns:read` | Get Landing Page Conversation |
+| [`getLandingPageDesignSystem`](#op-getlandingpagedesignsystem) | `GET /api/v1/landing-pages/design-system` | read | `campaigns:read` | Get Landing Page Design System |
+| [`getLandingPageManifest`](#op-getlandingpagemanifest) | `GET /api/v1/landing-pages/{landing_page_id}/manifest` | read | `campaigns:read` | Get Landing Page Manifest |
+| [`getLandingPageReportingOverview`](#op-getlandingpagereportingoverview) | `GET /api/v1/landing-pages/reporting/overview` | read | `campaigns:read` | Get Landing Page Reporting Overview |
+| [`getLandingPageSource`](#op-getlandingpagesource) | `GET /api/v1/landing-pages/agent-sessions/{session_id}` | read | `landing-pages:read` | Get Landing Page Source |
+| [`getLandingPageStatus`](#op-getlandingpagestatus) | `GET /api/v1/landing-pages/{landing_page_id}/status` | read | `campaigns:read` | Get Landing Page Status |
+| [`getLandingPageTracking`](#op-getlandingpagetracking) | `GET /api/v1/landing-pages/{landing_page_id}/tracking` | read | `campaigns:read` | Get Landing Page Tracking |
+| [`importLandingPageHtml`](#op-importlandingpagehtml) | `POST /api/v1/landing-pages/{landing_page_id}/import-html` | write | `campaigns:write` | Import Landing Page Html |
+| [`listLandingPageAnchors`](#op-listlandingpageanchors) | `GET /api/v1/landing-pages/{landing_page_id}/anchors` | read | `campaigns:read` | List Landing Page Anchors |
+| [`listLandingPageBindings`](#op-listlandingpagebindings) | `GET /api/v1/landing-pages/{landing_page_id}/bindings` | read | `campaigns:read` | List Landing Page Bindings |
+| [`listLandingPageComponents`](#op-listlandingpagecomponents) | `GET /api/v1/landing-pages/components` | read | `campaigns:read` | List Landing Page Components |
+| [`listLandingPageConsentStatus`](#op-listlandingpageconsentstatus) | `GET /api/v1/landing-page-consent/pages` | read | `campaigns:read` | List Landing Page Consent Status |
+| [`listLandingPageDomains`](#op-listlandingpagedomains) | `GET /api/v1/landing-pages/domains` | read | `campaigns:read` | List Landing Page Domains |
+| [`listLandingPageReportingCompanies`](#op-listlandingpagereportingcompanies) | `GET /api/v1/landing-pages/reporting/companies` | read | `campaigns:read` | List Landing Page Reporting Companies |
+| [`listLandingPageReportingPeople`](#op-listlandingpagereportingpeople) | `GET /api/v1/landing-pages/reporting/people` | read | `campaigns:read` | List Landing Page Reporting People |
+| [`listLandingPageVersions`](#op-listlandingpageversions) | `GET /api/v1/landing-pages/{landing_page_id}/versions` | read | `campaigns:read` | List Landing Page Versions |
+| [`listLandingPages`](#op-listlandingpages) | `GET /api/v1/landing-pages` | read | `campaigns:read` | List Landing Pages |
+| [`patchLandingPage`](#op-patchlandingpage) | `POST /api/v1/landing-pages/agent-sessions/{session_id}/patch` | write | `landing-pages:write` | Patch Landing Page |
+| [`promoteLandingPageTemplate`](#op-promotelandingpagetemplate) | `POST /api/v1/landing-pages/{landing_page_id}/promote-to-page` | write | `campaigns:write` | Promote Landing Page Template |
+| [`provisionLandingPageTracking`](#op-provisionlandingpagetracking) | `POST /api/v1/landing-pages/{landing_page_id}/tracking/provision` | write | `campaigns:write` | Provision Landing Page Tracking |
+| [`publishLandingPage`](#op-publishlandingpage) | `POST /api/v1/landing-pages/{landing_page_id}/publish` | external | `campaigns:run` | Publish Landing Page |
+| [`removeLandingPageBinding`](#op-removelandingpagebinding) | `DELETE /api/v1/landing-pages/{landing_page_id}/bindings` | destructive | `campaigns:delete` | Remove Landing Page Binding |
+| [`replaceLandingPageHtml`](#op-replacelandingpagehtml) | `POST /api/v1/landing-pages/{landing_page_id}/replace-html` | write | `campaigns:write` | Replace Landing Page Html |
+| [`restoreLandingPageVersion`](#op-restorelandingpageversion) | `POST /api/v1/landing-pages/{landing_page_id}/versions/{version_num}/restore` | write | `campaigns:write` | Restore Landing Page Version |
+| [`reviewLandingPage`](#op-reviewlandingpage) | `POST /api/v1/landing-pages/{landing_page_id}/ai-review` | billable | `campaigns:run` | Review Landing Page |
+| [`rewriteLandingPageText`](#op-rewritelandingpagetext) | `POST /api/v1/landing-pages/{landing_page_id}/rewrite-text` | billable | `campaigns:run` | Rewrite Landing Page Text |
+| [`saveLandingPageTemplateAsPage`](#op-savelandingpagetemplateaspage) | `POST /api/v1/landing-pages/{landing_page_id}/save-as-page` | write | `campaigns:write` | Save Landing Page Template As Page |
+| [`setLandingPageConsentDefault`](#op-setlandingpageconsentdefault) | `PUT /api/v1/landing-page-consent/default` | write | `campaigns:write` | Set Landing Page Consent Default |
+| [`setLandingPageMedia`](#op-setlandingpagemedia) | `POST /api/v1/landing-pages/{landing_page_id}/set-media-edit` | write | `campaigns:write` | Set Landing Page Media |
+| [`setLandingPageText`](#op-setlandingpagetext) | `POST /api/v1/landing-pages/{landing_page_id}/set-text` | write | `campaigns:write` | Set Landing Page Text |
+| [`unpublishLandingPage`](#op-unpublishlandingpage) | `POST /api/v1/landing-pages/{landing_page_id}/unpublish` | external | `campaigns:run` | Unpublish Landing Page |
+| [`updateLandingPage`](#op-updatelandingpage) | `PATCH /api/v1/landing-pages/{landing_page_id}` | write | `campaigns:write` | Update Landing Page |
+| [`updateLandingPageHtml`](#op-updatelandingpagehtml) | `POST /api/v1/landing-pages/{landing_page_id}/update-html` | write | `campaigns:write` | Update Landing Page Html |
+| [`updateLandingPageSection`](#op-updatelandingpagesection) | `PATCH /api/v1/landing-pages/{landing_page_id}/sections/{section_idx}` | write | `campaigns:write` | Update Landing Page Section |
+| [`updateLandingPageText`](#op-updatelandingpagetext) | `POST /api/v1/landing-pages/{landing_page_id}/update-text` | write | `campaigns:write` | Update Landing Page Text |
+| [`updateLandingPageTracking`](#op-updatelandingpagetracking) | `PATCH /api/v1/landing-pages/{landing_page_id}/tracking` | write | `campaigns:write` | Update Landing Page Tracking |
+
+---
+
+<a id="op-applylandingpagereviewfindings"></a>
+
+### `g8.api.landingPages.applyLandingPageReviewFindings(input)`
+
+**Apply Landing Page Review Findings**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/ai-review/apply`
+- operationId: `apply_landing_page_review_findings_landing_pages__landing_page_id__ai_review_apply_post` (also callable as `g8.api.call("apply_landing_page_review_findings_landing_pages__landing_page_id__ai_review_apply_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Apply findings DETERMINISTICALLY. FREE - no model runs.
+
+Prefer this to `/fix-with-ai` for anything the review already gave an
+exact replacement for; it costs nothing and cannot invent a change.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `AIReviewApplyRequest` | yes | Request body; fields below. |
+
+Body fields (`AIReviewApplyRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.finding_ids` | `Array<string>` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.applyLandingPageReviewFindings({ path: { landing_page_id: "id" }, body: { finding_ids: ["id"] } });
+```
+
+---
+
+<a id="op-approvelandingpagetemplate"></a>
+
+### `g8.api.landingPages.approveLandingPageTemplate(input)`
+
+**Approve Landing Page Template**
+
+- HTTP: `PATCH /api/v1/landing-pages/{landing_page_id}/approve-template`
+- operationId: `approve_landing_page_template_landing_pages__landing_page_id__approve_template_patch` (also callable as `g8.api.call("approve_landing_page_template_landing_pages__landing_page_id__approve_template_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Move a generated template from pending-approval to completed. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.approveLandingPageTemplate({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-clearlandingpageconsentoverride"></a>
+
+### `g8.api.landingPages.clearLandingPageConsentOverride(input)`
+
+**Clear Landing Page Consent Override**
+
+- HTTP: `DELETE /api/v1/landing-pages/{landing_page_id}/tracking/consent`
+- operationId: `clear_landing_page_consent_override_landing_pages__landing_page_id__tracking_consent_delete` (also callable as `g8.api.call("clear_landing_page_consent_override_landing_pages__landing_page_id__tracking_consent_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Drop the page's own consent settings so it inherits the workspace default.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.landingPages.clearLandingPageConsentOverride({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-clonehomepagetolandingpage"></a>
+
+### `g8.api.landingPages.cloneHomepageToLandingPage(input)`
+
+**Clone Homepage To Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/clone-homepage`
+- operationId: `clone_homepage_to_landing_page_landing_pages_clone_homepage_post` (also callable as `g8.api.call("clone_homepage_to_landing_page_landing_pages_clone_homepage_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Clone the org's homepage into an editable page. SPENDS CREDIT.
+
+`use_vision` is on by default and is the expensive half: it runs a
+multimodal pass over a screenshot so the clone looks like the original
+rather than like its HTML.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CloneHomepageRequest` | yes | Request body; fields below. |
+
+Body fields (`CloneHomepageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no |  |
+| `body.goal` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.use_vision` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.cloneHomepageToLandingPage({ body: {} });
+```
+
+---
+
+<a id="op-clonehtmltolandingpage"></a>
+
+### `g8.api.landingPages.cloneHtmlToLandingPage(input)`
+
+**Clone Html To Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/clone-html`
+- operationId: `clone_html_to_landing_page_landing_pages_clone_html_post` (also callable as `g8.api.call("clone_html_to_landing_page_landing_pages_clone_html_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Clone from raw source the caller already holds. SPENDS CREDIT.
+
+`use_vision` defaults OFF here and ON for `/clone-url`, which is the app's
+asymmetry and a real one: there is no live page to screenshot.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CloneHtmlRequest` | yes | Request body; fields below. |
+
+Body fields (`CloneHtmlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.html` | `string` | yes | min length 16, max length 2000000 |
+| `body.filename` | `string \| null` | no | Original filename - drives format detection (e.g. dialer.astro). max length 300 |
+| `body.name` | `string \| null` | no | max length 200 |
+| `body.source_url` | `string \| null` | no | max length 2048 |
+| `body.use_vision` | `boolean` | no | default `false` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.cloneHtmlToLandingPage({ body: { html: "xxxxxxxxxxxxxxxx" } });
+```
+
+---
+
+<a id="op-cloneurltolandingpage"></a>
+
+### `g8.api.landingPages.cloneUrlToLandingPage(input)`
+
+**Clone Url To Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/clone-url`
+- operationId: `clone_url_to_landing_page_landing_pages_clone_url_post` (also callable as `g8.api.call("clone_url_to_landing_page_landing_pages_clone_url_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Clone ANY public URL into an editable page. SPENDS CREDIT.
+
+It fetches the URL server-side, so the page has to be publicly reachable -
+this is not a way to read something behind the caller's own login.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CloneUrlRequest` | yes | Request body; fields below. |
+
+Body fields (`CloneUrlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.url` | `string` | yes | min length 1, max length 2048 |
+| `body.name` | `string \| null` | no | max length 200 |
+| `body.use_vision` | `boolean` | no | Multimodal pass. Costs more. Default on. default `true` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.cloneUrlToLandingPage({ body: { url: "https://example.com" } });
+```
+
+---
+
+<a id="op-convertlandingpagetofreeform"></a>
+
+### `g8.api.landingPages.convertLandingPageToFreeform(input)`
+
+**Convert Landing Page To Freeform**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/convert-to-freeform`
+- operationId: `convert_landing_page_to_freeform_landing_pages__landing_page_id__convert_to_freeform_post` (also callable as `g8.api.call("convert_landing_page_to_freeform_landing_pages__landing_page_id__convert_to_freeform_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Flatten a sections-mode page into freeform HTML. FREE.
+
+ONE-WAY: there is no convert-back, and `PATCH /sections/{idx}` stops
+applying to the page afterwards.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.convertLandingPageToFreeform({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-createlandingpage"></a>
+
+### `g8.api.landingPages.createLandingPage(input)`
+
+**Create Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages`
+- operationId: `create_landing_page_landing_pages_post` (also callable as `g8.api.call("create_landing_page_landing_pages_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Create a landing page. SPENDS CREDIT unless `generate` is false.
+
+`generate` defaults TRUE, matching Studio, and that default is the whole
+cost of this call: it runs the full copy-and-layout pass. Send
+`generate: false` for an empty page you will fill with `/clone-url`,
+`/import-html` or the deterministic edit routes.
+
+`created_by` is the API key's own principal. An organisation key records
+the key's identity rather than a person's, which is the honest answer -
+there is no human behind it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateLandingPageRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateLandingPageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.campaign_id` | `string \| null` | no |  |
+| `body.generate` | `boolean` | no | Run the AI generation pass. TRUE BY DEFAULT and it spends credit. default `true` |
+| `body.generation_mode` | `string \| null` | no | default `"freeform"` |
+| `body.goal` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.createLandingPage({ body: {} });
+```
+
+---
+
+<a id="op-createlandingpageagentsession"></a>
+
+### `g8.api.landingPages.createLandingPageAgentSession(input)`
+
+**Create Landing Page Agent Session**
+
+- HTTP: `POST /api/v1/landing-pages/{page_id}/agent-sessions`
+- operationId: `create_landing_page_agent_session_landing_pages__page_id__agent_sessions_post` (also callable as `g8.api.call("create_landing_page_agent_session_landing_pages__page_id__agent_sessions_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `integrations:write`
+
+Open a short-lived edit session against one landing page.
+
+Returns an `edit_session` id to pass to the two routes above. The session is
+a LOCATOR, not a credential: it selects which draft the following calls act
+on, and `get_api_user` still authenticates every one of them. It carries a
+TTL and is bound at creation to this org and this actor.
+
+`actor_email` is `str(user.id)`, byte-identical to what the read and patch
+routes pass to `require_edit_session`. That is what closes the loop: a
+session minted here resolves for the same key that minted it, and a mismatch
+would make every subsequent call 404 against a session that plainly exists.
+
+NO OWNABILITY GUARD, unlike the agent routes. `agent_router` refuses a write
+from a key whose `actor_identities()` is empty, because an org key
+authenticates as the shared constant `api-key@graph8.com`. The same constant
+lands in `actor_email` here, so two org keys in ONE org can read and patch
+each other's sessions. That is deliberate parity rather than an oversight:
+the two sibling routes already bind on `str(user.id)` and already accept org
+keys, so guarding only the create half would break the loop for exactly the
+keys the other half still serves. The boundary that matters is unchanged --
+`require_edit_session` rejects a session from another ORG. Tightening all
+three together belongs with the per-key identity work recorded in
+`.claude/agent-context/agent-runtime-api-key-door.md`.
+
+NOT SCOPE-GATED LOCALLY, unlike its two siblings, and that is deliberate
+rather than an oversight. They call `require_scope("landing-pages:...")`,
+which makes `build_scope_policy` record them as `exempt`; an exempt route
+publishes no `x-graph8-scope`, so their requirement is real but invisible in
+the contract -- and `landing-pages` is not a resource in
+`scope_vocabulary.json` at all, so the scope they name cannot be granted to
+a key. It is inert today only because `require_scope` runs in soak mode by
+default. Leaving this route ungated puts it in the GOVERNED set, where
+`apply_scope_policy` attaches the gate and the bundle publishes
+`integrations:write` -- the resource this file is actually mapped to. The
+siblings are left alone here: correcting them moves two published operations
+and belongs in its own change.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes |  |
+| `body` | `CreateAgentSessionRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approval_mode` | `string` | no | 'review' (default) stages each patch for a human to approve in Studio. 'auto_apply' writes straight to the draft. Bound to the session at creation, so a later patch cannot escalate itself. default `"review"`, pattern `^(review\|auto_apply)$` |
+
+**Returns** `ApiResponse_dict_str__Any__`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.createLandingPageAgentSession({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-createlandingpagepreviewlink"></a>
+
+### `g8.api.landingPages.createLandingPagePreviewLink(input)`
+
+**Create Landing Page Preview Link**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/preview`
+- operationId: `create_landing_page_preview_link_landing_pages__landing_page_id__preview_get` (also callable as `g8.api.call("create_landing_page_preview_link_landing_pages__landing_page_id__preview_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Mint a time-limited preview link for an UNPUBLISHED page. FREE.
+
+Anyone holding the link can view the draft until it expires - share it
+for review, not publicly. Nothing is published.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.createLandingPagePreviewLink({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-deletelandingpage"></a>
+
+### `g8.api.landingPages.deleteLandingPage(input)`
+
+**Delete Landing Page**
+
+- HTTP: `DELETE /api/v1/landing-pages/{landing_page_id}`
+- operationId: `delete_landing_page_landing_pages__landing_page_id__delete` (also callable as `g8.api.call("delete_landing_page_landing_pages__landing_page_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a landing page. Unpublish it first if it is live.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.landingPages.deleteLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-demotelandingpagetotemplate"></a>
+
+### `g8.api.landingPages.demoteLandingPageToTemplate(input)`
+
+**Demote Landing Page To Template**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/demote-to-template`
+- operationId: `demote_landing_page_to_template_landing_pages__landing_page_id__demote_to_template_post` (also callable as `g8.api.call("demote_landing_page_to_template_landing_pages__landing_page_id__demote_to_template_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Move a saved page back into the template list. FREE. Inverse of promote.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.demoteLandingPageToTemplate({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-duplicatelandingpagetemplate"></a>
+
+### `g8.api.landingPages.duplicateLandingPageTemplate(input)`
+
+**Duplicate Landing Page Template**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/duplicate`
+- operationId: `duplicate_landing_page_template_landing_pages__landing_page_id__duplicate_post` (also callable as `g8.api.call("duplicate_landing_page_template_landing_pages__landing_page_id__duplicate_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Copy a Brand Kit TEMPLATE as another template. FREE - no model runs.
+
+Only an org template can be duplicated (400 otherwise); to turn a
+template into an editable page use `/save-as-page`. `created_by` is the
+API key's own principal.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `DuplicateTemplateRequest` | yes | Request body; fields below. |
+
+Body fields (`DuplicateTemplateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string \| null` | no | max length 200 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.duplicateLandingPageTemplate({ path: { landing_page_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-editlandingpageelement"></a>
+
+### `g8.api.landingPages.editLandingPageElement(input)`
+
+**Edit Landing Page Element**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/edit-element`
+- operationId: `edit_landing_page_element_landing_pages__landing_page_id__edit_element_post` (also callable as `g8.api.call("edit_landing_page_element_landing_pages__landing_page_id__edit_element_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Edit ONE element by CSS selector with AI. SPENDS CREDIT.
+
+Freeform pages. Narrower and cheaper than `/edit-page`, which rewrites the
+whole document.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `EditElementRequest` | yes | Request body; fields below. |
+
+Body fields (`EditElementRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes |  |
+| `body.selector` | `string` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.editLandingPageElement({
+  path: { landing_page_id: "id" },
+  body: { instruction: "example", selector: "example" },
+});
+```
+
+---
+
+<a id="op-editlandingpagewhole"></a>
+
+### `g8.api.landingPages.editLandingPageWhole(input)`
+
+**Edit Landing Page Whole**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/edit-page`
+- operationId: `edit_landing_page_whole_landing_pages__landing_page_id__edit_page_post` (also callable as `g8.api.call("edit_landing_page_whole_landing_pages__landing_page_id__edit_page_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Rewrite the WHOLE page from one instruction. SPENDS CREDIT.
+
+The most expensive edit on this router - it puts the entire document
+through the model. Reach for `/edit-element` or `/rewrite-text` first.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `EditWithChatRequest` | yes | Request body; fields below. |
+
+Body fields (`EditWithChatRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes |  |
+| `body.section_idx` | `integer \| null` | no |  |
+| `body.selected_text` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.editLandingPageWhole({ path: { landing_page_id: "id" }, body: { instruction: "example" } });
+```
+
+---
+
+<a id="op-editlandingpagewithchat"></a>
+
+### `g8.api.landingPages.editLandingPageWithChat(input)`
+
+**Edit Landing Page With Chat**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/edit`
+- operationId: `edit_landing_page_with_chat_landing_pages__landing_page_id__edit_post` (also callable as `g8.api.call("edit_landing_page_with_chat_landing_pages__landing_page_id__edit_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Edit the page from a natural-language instruction. SPENDS CREDIT.
+
+The buffered form of the Studio chat edit. The streaming one is
+deliberately not published - see the module docstring.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `EditWithChatRequest` | yes | Request body; fields below. |
+
+Body fields (`EditWithChatRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes |  |
+| `body.section_idx` | `integer \| null` | no |  |
+| `body.selected_text` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.editLandingPageWithChat({ path: { landing_page_id: "id" }, body: { instruction: "example" } });
+```
+
+---
+
+<a id="op-ensurelandingpagebasetemplate"></a>
+
+### `g8.api.landingPages.ensureLandingPageBaseTemplate(input?)`
+
+**Ensure Landing Page Base Template**
+
+- HTTP: `POST /api/v1/landing-pages/ensure-base-template`
+- operationId: `ensure_landing_page_base_template_landing_pages_ensure_base_template_post` (also callable as `g8.api.call("ensure_landing_page_base_template_landing_pages_ensure_base_template_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Return the org's base template, creating it if there is none.
+
+IDEMPOTENT: it returns the existing template when one exists and spends
+nothing. It SPENDS CREDIT only on the first call for an org, where it
+clones the homepage to make one.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.ensureLandingPageBaseTemplate();
+```
+
+---
+
+<a id="op-exportlandingpage"></a>
+
+### `g8.api.landingPages.exportLandingPage(input)`
+
+**Export Landing Page**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/export`
+- operationId: `export_landing_page_landing_pages__landing_page_id__export_get` (also callable as `g8.api.call("export_landing_page_landing_pages__landing_page_id__export_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The page as one self-contained HTML document. FREE.
+
+For hosting the page yourself: styles and assets are inlined, so the
+document renders without graph8.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.exportLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-extractlandingpagecomponents"></a>
+
+### `g8.api.landingPages.extractLandingPageComponents(input?)`
+
+**Extract Landing Page Components**
+
+- HTTP: `POST /api/v1/landing-pages/components/extract`
+- operationId: `extract_landing_page_components_landing_pages_components_extract_post` (also callable as `g8.api.call("extract_landing_page_components_landing_pages_components_extract_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Re-extract components from the cloned homepage. SPENDS CREDIT.
+
+The same work `GET /components` returns the cached result of, run again on
+purpose - use the GET unless the homepage clone has changed.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.extractLandingPageComponents();
+```
+
+---
+
+<a id="op-fixlandingpagefindingwithai"></a>
+
+### `g8.api.landingPages.fixLandingPageFindingWithAi(input)`
+
+**Fix Landing Page Finding With Ai**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/ai-review/fix-with-ai`
+- operationId: `fix_landing_page_finding_with_ai_landing_pages__landing_page_id__ai_review_fix_with_ai_post` (also callable as `g8.api.call("fix_landing_page_finding_with_ai_landing_pages__landing_page_id__ai_review_fix_with_ai_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Send ONE finding to the edit engine. SPENDS CREDIT, per finding.
+
+One call per finding: fixing ten findings is ten passes, not one.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `AIReviewFixWithAIRequest` | yes | Request body; fields below. |
+
+Body fields (`AIReviewFixWithAIRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.finding` | `Record<string, unknown>` | yes |  |
+| `body.brand_mode` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.fixLandingPageFindingWithAi({ path: { landing_page_id: "id" }, body: { finding: {} } });
+```
+
+---
+
+<a id="op-generatelandingpageseometadata"></a>
+
+### `g8.api.landingPages.generateLandingPageSeoMetadata(input)`
+
+**Generate Landing Page Seo Metadata**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/generate-seo-metadata`
+- operationId: `generate_landing_page_seo_metadata_landing_pages__landing_page_id__generate_seo_metadata_post` (also callable as `g8.api.call("generate_landing_page_seo_metadata_landing_pages__landing_page_id__generate_seo_metadata_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Derive title, description and keywords from the page. SPENDS CREDIT.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.generateLandingPageSeoMetadata({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpage"></a>
+
+### `g8.api.landingPages.getLandingPage(input)`
+
+**Get Landing Page**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}`
+- operationId: `get_landing_page_landing_pages__landing_page_id__get` (also callable as `g8.api.call("get_landing_page_landing_pages__landing_page_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One page with its full detail, including its HTML. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpageconsentdefault"></a>
+
+### `g8.api.landingPages.getLandingPageConsentDefault(input?)`
+
+**Get Landing Page Consent Default**
+
+- HTTP: `GET /api/v1/landing-page-consent/default`
+- operationId: `get_landing_page_consent_default_landing_page_consent_default_get` (also callable as `g8.api.call("get_landing_page_consent_default_landing_page_consent_default_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The workspace-wide consent gate default. FREE. `consent: null` means none is set.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageConsentDefault();
+```
+
+---
+
+<a id="op-getlandingpageconversation"></a>
+
+### `g8.api.landingPages.getLandingPageConversation(input)`
+
+**Get Landing Page Conversation**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/conversation`
+- operationId: `get_landing_page_conversation_landing_pages__landing_page_id__conversation_get` (also callable as `g8.api.call("get_landing_page_conversation_landing_pages__landing_page_id__conversation_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The AI edit conversation recorded against this page. FREE.
+
+Every `/edit`, `/edit-element` and `/edit-page` instruction and the
+assistant's reply, in order.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageConversation({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpagedesignsystem"></a>
+
+### `g8.api.landingPages.getLandingPageDesignSystem(input?)`
+
+**Get Landing Page Design System**
+
+- HTTP: `GET /api/v1/landing-pages/design-system`
+- operationId: `get_landing_page_design_system_landing_pages_design_system_get` (also callable as `g8.api.call("get_landing_page_design_system_landing_pages_design_system_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's colours, type and spacing, as generation uses them. FREE.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageDesignSystem();
+```
+
+---
+
+<a id="op-getlandingpagemanifest"></a>
+
+### `g8.api.landingPages.getLandingPageManifest(input)`
+
+**Get Landing Page Manifest**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/manifest`
+- operationId: `get_landing_page_manifest_landing_pages__landing_page_id__manifest_get` (also callable as `g8.api.call("get_landing_page_manifest_landing_pages__landing_page_id__manifest_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The element manifest. FREE.
+
+The SOURCE of the `element_id` values `/set-text`, `/update-text` and
+`/set-media-edit` accept. Read it first - an id invented by hand addresses
+nothing, and `/import-html` with `reassign_g8_ids` invalidates every id you
+are holding.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageManifest({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpagereportingoverview"></a>
+
+### `g8.api.landingPages.getLandingPageReportingOverview(input?)`
+
+**Get Landing Page Reporting Overview**
+
+- HTTP: `GET /api/v1/landing-pages/reporting/overview`
+- operationId: `get_landing_page_reporting_overview_landing_pages_reporting_overview_get` (also callable as `g8.api.call("get_landing_page_reporting_overview_landing_pages_reporting_overview_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Landing-page performance: visits, identified people and companies, conversions. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Look-back window in days. default `30` |
+| `query.page_id` | `Array<string> \| null` | no | Only these pages. Repeat the parameter. |
+| `query.source` | `"all" \| "paid" \| "email" \| "organic" \| "referral" \| "direct"` | no | Traffic source. default `"all"` |
+| `query.observed_campaign` | `string \| null` | no | Only this UTM campaign. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageReportingOverview();
+```
+
+---
+
+<a id="op-getlandingpagesource"></a>
+
+### `g8.api.landingPages.getLandingPageSource(input)`
+
+**Get Landing Page Source**
+
+- HTTP: `GET /api/v1/landing-pages/agent-sessions/{session_id}`
+- operationId: `get_landing_page_source_landing_pages_agent_sessions__session_id__get` (also callable as `g8.api.call("get_landing_page_source_landing_pages_agent_sessions__session_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `landing-pages:read`
+
+Return exact source for the draft bound to an edit session.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.session_id` | `string` | yes |  |
+
+**Returns** `ApiResponse_dict_str__Any__`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageSource({ path: { session_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpagestatus"></a>
+
+### `g8.api.landingPages.getLandingPageStatus(input)`
+
+**Get Landing Page Status**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/status`
+- operationId: `get_landing_page_status_landing_pages__landing_page_id__status_get` (also callable as `g8.api.call("get_landing_page_status_landing_pages__landing_page_id__status_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Generation progress for one page. FREE.
+
+The poll target after `POST /landing-pages` or a clone: generation runs in
+the background and this says whether the page is still being written.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageStatus({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-getlandingpagetracking"></a>
+
+### `g8.api.landingPages.getLandingPageTracking(input)`
+
+**Get Landing Page Tracking**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/tracking`
+- operationId: `get_landing_page_tracking_landing_pages__landing_page_id__tracking_get` (also callable as `g8.api.call("get_landing_page_tracking_landing_pages__landing_page_id__tracking_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The page's tracking mode, form id, chat widget, consent and conversion goal. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.getLandingPageTracking({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-importlandingpagehtml"></a>
+
+### `g8.api.landingPages.importLandingPageHtml(input)`
+
+**Import Landing Page Html**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/import-html`
+- operationId: `import_landing_page_html_landing_pages__landing_page_id__import_html_post` (also callable as `g8.api.call("import_landing_page_html_landing_pages__landing_page_id__import_html_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Import externally edited HTML into the draft. FREE.
+
+`commit` defaults FALSE, which makes the default call a DRY RUN reporting
+what would change. Send `commit: true` to write it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `ImportHtmlRequest` | yes | Request body; fields below. |
+
+Body fields (`ImportHtmlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.html` | `string` | yes | min length 16, max length 2000000 |
+| `body.commit` | `boolean` | no | False previews; true writes the draft. default `false` |
+| `body.confirm_action_rebuild` | `boolean` | no | default `false` |
+| `body.reassign_g8_ids` | `boolean` | no | default `false` |
+| `body.reinfer_button_actions` | `boolean` | no | default `false` |
+| `body.strip_vendor_css` | `boolean` | no | default `false` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.importLandingPageHtml({
+  path: { landing_page_id: "id" },
+  body: { html: "xxxxxxxxxxxxxxxx" },
+});
+```
+
+---
+
+<a id="op-listlandingpageanchors"></a>
+
+### `g8.api.landingPages.listLandingPageAnchors(input)`
+
+**List Landing Page Anchors**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/anchors`
+- operationId: `list_landing_page_anchors_landing_pages__landing_page_id__anchors_get` (also callable as `g8.api.call("list_landing_page_anchors_landing_pages__landing_page_id__anchors_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The page's named anchors. FREE - the valid targets for an in-page link.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageAnchors({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-listlandingpagebindings"></a>
+
+### `g8.api.landingPages.listLandingPageBindings(input)`
+
+**List Landing Page Bindings**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/bindings`
+- operationId: `list_landing_page_bindings_landing_pages__landing_page_id__bindings_get` (also callable as `g8.api.call("list_landing_page_bindings_landing_pages__landing_page_id__bindings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every URL this page is currently served at. FREE.
+
+One page can be bound to several. Read this before unpublishing, because
+unpublishing drops all of them at once.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageBindings({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-listlandingpagecomponents"></a>
+
+### `g8.api.landingPages.listLandingPageComponents(input?)`
+
+**List Landing Page Components**
+
+- HTTP: `GET /api/v1/landing-pages/components`
+- operationId: `list_landing_page_components_landing_pages_components_get` (also callable as `g8.api.call("list_landing_page_components_landing_pages_components_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+UI components extracted from the org's cloned homepage. FREE.
+
+Reads what a previous extraction stored. `POST /components/extract` is the
+one that re-derives them.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageComponents();
+```
+
+---
+
+<a id="op-listlandingpageconsentstatus"></a>
+
+### `g8.api.landingPages.listLandingPageConsentStatus(input?)`
+
+**List Landing Page Consent Status**
+
+- HTTP: `GET /api/v1/landing-page-consent/pages`
+- operationId: `list_landing_page_consent_status_landing_page_consent_pages_get` (also callable as `g8.api.call("list_landing_page_consent_status_landing_page_consent_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Per published page: is the consent gate ACTUALLY live on it. FREE.
+
+Read from the published HTML, not the settings - `stale_count` is how
+many pages need a re-publish to pick up the current configuration.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageConsentStatus();
+```
+
+---
+
+<a id="op-listlandingpagedomains"></a>
+
+### `g8.api.landingPages.listLandingPageDomains(input?)`
+
+**List Landing Page Domains**
+
+- HTTP: `GET /api/v1/landing-pages/domains`
+- operationId: `list_landing_page_domains_landing_pages_domains_get` (also callable as `g8.api.call("list_landing_page_domains_landing_pages_domains_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The domains a page can be published on. FREE.
+
+The org's verified custom domains plus the default hosted domain - the
+valid values for `domain` on `POST /landing-pages/{id}/publish`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageDomains();
+```
+
+---
+
+<a id="op-listlandingpagereportingcompanies"></a>
+
+### `g8.api.landingPages.listLandingPageReportingCompanies(input?)`
+
+**List Landing Page Reporting Companies**
+
+- HTTP: `GET /api/v1/landing-pages/reporting/companies`
+- operationId: `list_landing_page_reporting_companies_landing_pages_reporting_companies_get` (also callable as `g8.api.call("list_landing_page_reporting_companies_landing_pages_reporting_companies_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The COMPANIES whose people visited. FREE. Page with `cursor`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.cursor` | `integer` | no | default `0` |
+| `query.limit` | `integer` | no | default `50` |
+| `query.days` | `integer` | no | Look-back window in days. default `30` |
+| `query.page_id` | `Array<string> \| null` | no | Only these pages. Repeat the parameter. |
+| `query.source` | `"all" \| "paid" \| "email" \| "organic" \| "referral" \| "direct"` | no | Traffic source. default `"all"` |
+| `query.observed_campaign` | `string \| null` | no | Only this UTM campaign. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageReportingCompanies();
+```
+
+---
+
+<a id="op-listlandingpagereportingpeople"></a>
+
+### `g8.api.landingPages.listLandingPageReportingPeople(input?)`
+
+**List Landing Page Reporting People**
+
+- HTTP: `GET /api/v1/landing-pages/reporting/people`
+- operationId: `list_landing_page_reporting_people_landing_pages_reporting_people_get` (also callable as `g8.api.call("list_landing_page_reporting_people_landing_pages_reporting_people_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The identified PEOPLE who visited, with what they viewed. FREE. Page with `cursor`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.cursor` | `integer` | no | default `0` |
+| `query.limit` | `integer` | no | default `50` |
+| `query.days` | `integer` | no | Look-back window in days. default `30` |
+| `query.page_id` | `Array<string> \| null` | no | Only these pages. Repeat the parameter. |
+| `query.source` | `"all" \| "paid" \| "email" \| "organic" \| "referral" \| "direct"` | no | Traffic source. default `"all"` |
+| `query.observed_campaign` | `string \| null` | no | Only this UTM campaign. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageReportingPeople();
+```
+
+---
+
+<a id="op-listlandingpageversions"></a>
+
+### `g8.api.landingPages.listLandingPageVersions(input)`
+
+**List Landing Page Versions**
+
+- HTTP: `GET /api/v1/landing-pages/{landing_page_id}/versions`
+- operationId: `list_landing_page_versions_landing_pages__landing_page_id__versions_get` (also callable as `g8.api.call("list_landing_page_versions_landing_pages__landing_page_id__versions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The page's saved versions, newest first. FREE.
+
+Every edit route snapshots the page before it changes it; these are the
+snapshots `POST .../versions/{version_num}/restore` can roll back to.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPageVersions({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-listlandingpages"></a>
+
+### `g8.api.landingPages.listLandingPages(input?)`
+
+**List Landing Pages**
+
+- HTTP: `GET /api/v1/landing-pages`
+- operationId: `list_landing_pages_landing_pages_get` (also callable as `g8.api.call("list_landing_pages_landing_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every landing page in the org. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.status` | `string \| null` | no | Filter by page status (draft, published, ...). |
+| `query.limit` | `integer` | no | default `50` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.listLandingPages();
+```
+
+---
+
+<a id="op-patchlandingpage"></a>
+
+### `g8.api.landingPages.patchLandingPage(input)`
+
+**Patch Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/agent-sessions/{session_id}/patch`
+- operationId: `patch_landing_page_landing_pages_agent_sessions__session_id__patch_post` (also callable as `g8.api.call("patch_landing_page_landing_pages_agent_sessions__session_id__patch_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `landing-pages:write`
+
+Submit an exact patch using the handoff's selected approval mode.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.session_id` | `string` | yes |  |
+| `body` | `LandingPagePatchRequest` | yes | Request body; fields below. |
+
+Body fields (`LandingPagePatchRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.base_sha256` | `string` | yes | pattern `^[a-f0-9]{64}$` |
+| `body.idempotency_key` | `string` | yes | min length 8, max length 128, pattern `^[A-Za-z0-9._:-]+$` |
+| `body.replacements` | `Array<ExactReplacementRequest>` | yes | min items 1, max items 20 |
+| `body.summary` | `string` | no | default `"External AI edit"`, max length 500 |
+
+**Returns** `ApiResponse_dict_str__Any__`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.patchLandingPage({
+  path: { session_id: "id" },
+  body: {
+    base_sha256: "example",
+    idempotency_key: "xxxxxxxx",
+    replacements: [{ new: "example", old: "example" }],
+  },
+});
+```
+
+---
+
+<a id="op-promotelandingpagetemplate"></a>
+
+### `g8.api.landingPages.promoteLandingPageTemplate(input)`
+
+**Promote Landing Page Template**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/promote-to-page`
+- operationId: `promote_landing_page_template_landing_pages__landing_page_id__promote_to_page_post` (also callable as `g8.api.call("promote_landing_page_template_landing_pages__landing_page_id__promote_to_page_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Turn a template INTO a page. FREE.
+
+It MOVES the row rather than copying it - the template stops being a
+template. `/save-as-page` is the copying version, and `/demote-to-template`
+is the inverse of this one.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.promoteLandingPageTemplate({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-provisionlandingpagetracking"></a>
+
+### `g8.api.landingPages.provisionLandingPageTracking(input)`
+
+**Provision Landing Page Tracking**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/tracking/provision`
+- operationId: `provision_landing_page_tracking_landing_pages__landing_page_id__tracking_provision_post` (also callable as `g8.api.call("provision_landing_page_tracking_landing_pages__landing_page_id__tracking_provision_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Give the page its OWN tracking stream and browser key. FREE.
+
+Switches the page to `dedicated` tracking; takes effect on its next
+publish. The form id label and chat setting are preserved.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.provisionLandingPageTracking({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-publishlandingpage"></a>
+
+### `g8.api.landingPages.publishLandingPage(input)`
+
+**Publish Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/publish`
+- operationId: `publish_landing_page_landing_pages__landing_page_id__publish_post` (also callable as `g8.api.call("publish_landing_page_landing_pages__landing_page_id__publish_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `campaigns:run`
+
+Deploy the page to a PUBLIC URL. Real people can reach it immediately.
+
+Spends no credit, but it is the outward-facing operation on this router
+and is tiered and gated accordingly - `CAMPAIGNS_LAUNCH`, the same
+permission the app requires, re-declared on this route because the app's
+own `Depends` gate does not run on a direct call.
+
+Omit the body to publish at the page's own slug on the org's default
+domain. `override: true` takes a URL that is already bound to a DIFFERENT
+page, and that page stops serving at it.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `PublishLandingPageRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.domain` | `string \| null` | no |  |
+| `body.domain_id` | `integer \| null` | no |  |
+| `body.override` | `boolean` | no | Steal a URL already bound to another page. Default false. default `false` |
+| `body.path` | `string \| null` | no |  |
+| `body.slug` | `string \| null` | no |  |
+| `body.subdomain` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.landingPages.publishLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-removelandingpagebinding"></a>
+
+### `g8.api.landingPages.removeLandingPageBinding(input)`
+
+**Remove Landing Page Binding**
+
+- HTTP: `DELETE /api/v1/landing-pages/{landing_page_id}/bindings`
+- operationId: `remove_landing_page_binding_landing_pages__landing_page_id__bindings_delete` (also callable as `g8.api.call("remove_landing_page_binding_landing_pages__landing_page_id__bindings_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Stop serving the page at ONE URL. The others keep working.
+
+The surgical version of `/unpublish`, and outward-facing for the same
+reason: that URL 404s from this moment. Launch-gated.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `query.hostname` | `string` | yes | The host to stop serving this page at. |
+| `query.path` | `string` | no | The path under that host. Defaults to the root. default `"/"` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.landingPages.removeLandingPageBinding({ path: { landing_page_id: "id" }, query: { hostname: "Example" } });
+```
+
+---
+
+<a id="op-replacelandingpagehtml"></a>
+
+### `g8.api.landingPages.replaceLandingPageHtml(input)`
+
+**Replace Landing Page Html**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/replace-html`
+- operationId: `replace_landing_page_html_landing_pages__landing_page_id__replace_html_post` (also callable as `g8.api.call("replace_landing_page_html_landing_pages__landing_page_id__replace_html_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Persist a whole-page snapshot. FREE.
+
+Wholesale: whatever is not in `html` is gone. It creates a restorable
+version first, which is the only thing standing between a bad snapshot and
+a lost page.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `ReplaceHtmlRequest` | yes | Request body; fields below. |
+
+Body fields (`ReplaceHtmlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.html` | `string` | yes | max length 2000000 |
+| `body.edit_instruction` | `string \| null` | no | max length 240 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.replaceLandingPageHtml({ path: { landing_page_id: "id" }, body: { html: "example" } });
+```
+
+---
+
+<a id="op-restorelandingpageversion"></a>
+
+### `g8.api.landingPages.restoreLandingPageVersion(input)`
+
+**Restore Landing Page Version**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/versions/{version_num}/restore`
+- operationId: `restore_landing_page_version_landing_pages__landing_page_id__versions__version_num__restore_post` (also callable as `g8.api.call("restore_landing_page_version_landing_pages__landing_page_id__versions__version_num__restore_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Roll the page back to a saved version. FREE - no model runs.
+
+The current state is snapshotted first, so a restore is itself undoable.
+A PUBLISHED page keeps serving its published HTML until it is published
+again.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `path.version_num` | `integer` | yes | Version number, from `GET .../versions`. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.restoreLandingPageVersion({ path: { landing_page_id: "id", version_num: 1 } });
+```
+
+---
+
+<a id="op-reviewlandingpage"></a>
+
+### `g8.api.landingPages.reviewLandingPage(input)`
+
+**Review Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/ai-review`
+- operationId: `review_landing_page_landing_pages__landing_page_id__ai_review_post` (also callable as `g8.api.call("review_landing_page_landing_pages__landing_page_id__ai_review_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Run a review pass and return findings. SPENDS CREDIT.
+
+It CHANGES NOTHING - the findings are applied by
+`/ai-review/apply` (free, deterministic) or `/ai-review/fix-with-ai`
+(another model pass). Reviewing is still a spend even though it is
+read-only against the page, which is why it is not tiered as a read.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `AIReviewRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.deep` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.reviewLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-rewritelandingpagetext"></a>
+
+### `g8.api.landingPages.rewriteLandingPageText(input)`
+
+**Rewrite Landing Page Text**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/rewrite-text`
+- operationId: `rewrite_landing_page_text_landing_pages__landing_page_id__rewrite_text_post` (also callable as `g8.api.call("rewrite_landing_page_text_landing_pages__landing_page_id__rewrite_text_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Rewrite one element's text with AI. SPENDS CREDIT.
+
+Text only - no HTML is generated - which makes it the cheapest AI edit
+here and the right one for a copy change.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `LandingPageRewriteTextRequest` | yes | Request body; fields below. |
+
+Body fields (`LandingPageRewriteTextRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes |  |
+| `body.selected_element` | `SelectedElementPayload` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.landingPages.rewriteLandingPageText({
+  path: { landing_page_id: "id" },
+  body: {
+    instruction: "example",
+    selected_element: { element_id: "id", tag: "example" },
+  },
+});
+```
+
+---
+
+<a id="op-savelandingpagetemplateaspage"></a>
+
+### `g8.api.landingPages.saveLandingPageTemplateAsPage(input)`
+
+**Save Landing Page Template As Page**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/save-as-page`
+- operationId: `save_landing_page_template_as_page_landing_pages__landing_page_id__save_as_page_post` (also callable as `g8.api.call("save_landing_page_template_as_page_landing_pages__landing_page_id__save_as_page_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Copy an org TEMPLATE into a new editable page. FREE.
+
+The template is untouched, which is the difference from
+`/promote-to-page`: that one MOVES the template out of the template list.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.saveLandingPageTemplateAsPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-setlandingpageconsentdefault"></a>
+
+### `g8.api.landingPages.setLandingPageConsentDefault(input)`
+
+**Set Landing Page Consent Default**
+
+- HTTP: `PUT /api/v1/landing-page-consent/default`
+- operationId: `set_landing_page_consent_default_landing_page_consent_default_put` (also callable as `g8.api.call("set_landing_page_consent_default_landing_page_consent_default_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Set the workspace-wide consent gate default. ADMIN ONLY.
+
+A compliance control for every page that does not override it. Takes
+effect on each page's NEXT publish - already-published HTML is not
+rewritten; `GET /landing-page-consent/pages` shows which pages are stale.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `LandingPageConsentConfig` | yes | Request body; fields below. |
+
+Body fields (`LandingPageConsentConfig`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.accent` | `string` | no | Hex colour. default `"#111827"`, max length 7 |
+| `body.accept_label` | `string` | no | default `"Accept"`, max length 40 |
+| `body.banner` | `boolean` | no | False when your own consent manager drives the gate. default `true` |
+| `body.message` | `string` | no | default `"We use cookies and similar technologies to measure traffic and improve this site. You can accept or reject them."`, max length 600 |
+| `body.mode` | `"off" \| "explicit" \| "region"` | no | default `"off"` |
+| `body.policy_label` | `string` | no | default `"Privacy policy"`, max length 60 |
+| `body.policy_url` | `string \| null` | no | max length 500 |
+| `body.regions` | `Array<"EEA">` | no | Only used when mode is `region`. min items 1 |
+| `body.reject_label` | `string` | no | default `"Reject"`, max length 40 |
+| `body.reopener` | `boolean` | no | default `true` |
+| `body.reopener_label` | `string` | no | default `"Cookie settings"`, max length 40 |
+| `body.title` | `string` | no | default `"We use cookies"`, max length 120 |
+| `body.version` | `integer` | no | Bump to re-prompt every visitor. default `1`, min 1, max 1000000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.setLandingPageConsentDefault({ body: {} });
+```
+
+---
+
+<a id="op-setlandingpagemedia"></a>
+
+### `g8.api.landingPages.setLandingPageMedia(input)`
+
+**Set Landing Page Media**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/set-media-edit`
+- operationId: `set_landing_page_media_landing_pages__landing_page_id__set_media_edit_post` (also callable as `g8.api.call("set_landing_page_media_landing_pages__landing_page_id__set_media_edit_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Point an `<img>` / `<video>` at a URL, or remove it. FREE.
+
+`remove: true` DELETES the element. It is the one destructive field in the
+body and it is not implied by any other field.
+
+This is the API-shaped alternative to the multipart upload route, which is
+deliberately not published: host the asset (the image library will do it),
+then send its URL here.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `LandingPageSetMediaEditRequest` | yes | Request body; fields below. |
+
+Body fields (`LandingPageSetMediaEditRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.g8_action_id` | `string` | yes | min length 1, max length 120 |
+| `body.kind` | `"img" \| "video"` | yes |  |
+| `body.alt` | `string \| null` | no | max length 500 |
+| `body.autoplay` | `boolean \| null` | no |  |
+| `body.controls` | `boolean \| null` | no |  |
+| `body.loop` | `boolean \| null` | no |  |
+| `body.muted` | `boolean \| null` | no |  |
+| `body.object_fit` | `"cover" \| "contain" \| "fill" \| "none" \| "scale-down" \| null` | no |  |
+| `body.object_position` | `string \| null` | no | max length 80 |
+| `body.position` | `MediaPosition \| null` | no |  |
+| `body.poster` | `string \| null` | no | max length 2048 |
+| `body.remove` | `boolean` | no | default `false` |
+| `body.src` | `string \| null` | no | max length 2048 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.setLandingPageMedia({
+  path: { landing_page_id: "id" },
+  body: { g8_action_id: "id", kind: "img" },
+});
+```
+
+---
+
+<a id="op-setlandingpagetext"></a>
+
+### `g8.api.landingPages.setLandingPageText(input)`
+
+**Set Landing Page Text**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/set-text`
+- operationId: `set_landing_page_text_landing_pages__landing_page_id__set_text_post` (also callable as `g8.api.call("set_landing_page_text_landing_pages__landing_page_id__set_text_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Set the VISIBLE TEXT of one element. FREE - markup is preserved.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `LandingPageSetTextRequest` | yes | Request body; fields below. |
+
+Body fields (`LandingPageSetTextRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.element_id` | `string` | yes |  |
+| `body.new_text` | `string` | yes |  |
+| `body.selected_element` | `SelectedElementPayload \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.setLandingPageText({
+  path: { landing_page_id: "id" },
+  body: { element_id: "id", new_text: "example" },
+});
+```
+
+---
+
+<a id="op-unpublishlandingpage"></a>
+
+### `g8.api.landingPages.unpublishLandingPage(input)`
+
+**Unpublish Landing Page**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/unpublish`
+- operationId: `unpublish_landing_page_landing_pages__landing_page_id__unpublish_post` (also callable as `g8.api.call("unpublish_landing_page_landing_pages__landing_page_id__unpublish_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `campaigns:run`
+
+Take the page OFF the internet. Every URL it served stops resolving.
+
+Visitors and any ad or email pointing at it get a 404 from this moment.
+Launch-gated for the same reason publishing is.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.landingPages.unpublishLandingPage({ path: { landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-updatelandingpage"></a>
+
+### `g8.api.landingPages.updateLandingPage(input)`
+
+**Update Landing Page**
+
+- HTTP: `PATCH /api/v1/landing-pages/{landing_page_id}`
+- operationId: `update_landing_page_landing_pages__landing_page_id__patch` (also callable as `g8.api.call("update_landing_page_landing_pages__landing_page_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Metadata only - name, slug, description, settings. FREE.
+
+Nothing here touches the page's HTML. The edit routes do that.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `UpdateLandingPageRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateLandingPageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.settings` | `Record<string, unknown> \| null` | no |  |
+| `body.slug` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.updateLandingPage({ path: { landing_page_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updatelandingpagehtml"></a>
+
+### `g8.api.landingPages.updateLandingPageHtml(input)`
+
+**Update Landing Page Html**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/update-html`
+- operationId: `update_landing_page_html_landing_pages__landing_page_id__update_html_post` (also callable as `g8.api.call("update_landing_page_html_landing_pages__landing_page_id__update_html_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Save raw HTML for a freeform page. FREE - the code-editor save.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `UpdateHtmlRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateHtmlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.html` | `string` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.updateLandingPageHtml({ path: { landing_page_id: "id" }, body: { html: "example" } });
+```
+
+---
+
+<a id="op-updatelandingpagesection"></a>
+
+### `g8.api.landingPages.updateLandingPageSection(input)`
+
+**Update Landing Page Section**
+
+- HTTP: `PATCH /api/v1/landing-pages/{landing_page_id}/sections/{section_idx}`
+- operationId: `update_landing_page_section_landing_pages__landing_page_id__sections__section_idx__patch` (also callable as `g8.api.call("update_landing_page_section_landing_pages__landing_page_id__sections__section_idx__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Replace one section's content block. FREE - no model runs.
+
+Sections-mode pages only. A freeform page has no section array; use
+`/replace-html` or `/set-text` on those.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `path.section_idx` | `integer` | yes | Zero-based section index. |
+| `body` | `UpdateSectionRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateSectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content` | `Record<string, unknown>` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.updateLandingPageSection({
+  path: { landing_page_id: "id", section_idx: 0 },
+  body: { content: {} },
+});
+```
+
+---
+
+<a id="op-updatelandingpagetext"></a>
+
+### `g8.api.landingPages.updateLandingPageText(input)`
+
+**Update Landing Page Text**
+
+- HTTP: `POST /api/v1/landing-pages/{landing_page_id}/update-text`
+- operationId: `update_landing_page_text_landing_pages__landing_page_id__update_text_post` (also callable as `g8.api.call("update_landing_page_text_landing_pages__landing_page_id__update_text_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Set one element's inner HTML directly. FREE.
+
+`new_html`, not `new_text`: this one accepts markup. `/set-text` is the
+text-only sibling and is the safer of the two.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `UpdateTextRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateTextRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.element_id` | `string` | yes |  |
+| `body.new_html` | `string` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.updateLandingPageText({
+  path: { landing_page_id: "id" },
+  body: { element_id: "id", new_html: "example" },
+});
+```
+
+---
+
+<a id="op-updatelandingpagetracking"></a>
+
+### `g8.api.landingPages.updateLandingPageTracking(input)`
+
+**Update Landing Page Tracking**
+
+- HTTP: `PATCH /api/v1/landing-pages/{landing_page_id}/tracking`
+- operationId: `update_landing_page_tracking_landing_pages__landing_page_id__tracking_patch` (also callable as `g8.api.call("update_landing_page_tracking_landing_pages__landing_page_id__tracking_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Change the page's tracking settings. FREE. Only the fields you send change.
+
+Moving TO `dedicated` goes through `/tracking/provision`; a PATCH to it is
+rejected. Takes effect on the page's next publish.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.landing_page_id` | `string` | yes | Landing page id. |
+| `body` | `LandingPageTrackingPatchRequest` | yes | Request body; fields below. |
+
+Body fields (`LandingPageTrackingPatchRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.chat_enabled` | `boolean \| null` | no |  |
+| `body.consent` | `LandingPageConsentConfig \| null` | no |  |
+| `body.conversion_goal` | `"form_submission" \| "workspace_signup" \| "paid_account" \| "traffic_only" \| null` | no |  |
+| `body.form_id` | `string \| null` | no | max length 80 |
+| `body.mode` | `"org_default" \| "dedicated" \| "disabled" \| null` | no | `dedicated` is reached through `/tracking/provision`, not here. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.landingPages.updateLandingPageTracking({ path: { landing_page_id: "id" }, body: {} });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-exactreplacementrequest"></a>
+
+### `ExactReplacementRequest`
+
+One exact replacement applied against the evolving HTML document.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `new` | `string` | yes | max length 500000 |
+| `old` | `string` | yes | min length 1, max length 200000 |
+| `expected_matches` | `integer` | no | default `1`, min 1, max 100 |
+
+<a id="type-mediaposition"></a>
+
+### `MediaPosition`
+
+Per-breakpoint drag offsets. `desktop` is required; the rest inherit.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `desktop` | `MediaPositionOffset` | yes |  |
+| `mobile` | `MediaPositionOffset \| null` | no |  |
+| `tablet` | `MediaPositionOffset \| null` | no |  |
+
+<a id="type-selectedelementpayload"></a>
+
+### `SelectedElementPayload`
+
+What the visual picker selected, as the rewrite pass needs to see it.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `element_id` | `string` | yes |  |
+| `tag` | `string` | yes |  |
+| `outer_html` | `string \| null` | no |  |
+| `role` | `string \| null` | no |  |
+| `scope` | `string` | no | default `"element"` |
+| `section_id` | `string \| null` | no |  |
+| `text` | `string \| null` | no |  |