@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/landingPages.d.ts

@@ -0,0 +1,1411 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.landingPages` (Landing Pages): 59 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"apply_landing_page_review_findings_landing_pages__landing_page_id__ai_review_apply_post">;
+ *
+ * Reference with examples: landingPages.md
+ */
+/* eslint-disable */
+
+/** `g8.api.landingPages.<member>` -> the operationId it calls. */
+export interface LandingPagesMembers {
+  applyLandingPageReviewFindings: "apply_landing_page_review_findings_landing_pages__landing_page_id__ai_review_apply_post";
+  approveLandingPageTemplate: "approve_landing_page_template_landing_pages__landing_page_id__approve_template_patch";
+  clearLandingPageConsentOverride: "clear_landing_page_consent_override_landing_pages__landing_page_id__tracking_consent_delete";
+  cloneHomepageToLandingPage: "clone_homepage_to_landing_page_landing_pages_clone_homepage_post";
+  cloneHtmlToLandingPage: "clone_html_to_landing_page_landing_pages_clone_html_post";
+  cloneUrlToLandingPage: "clone_url_to_landing_page_landing_pages_clone_url_post";
+  convertLandingPageToFreeform: "convert_landing_page_to_freeform_landing_pages__landing_page_id__convert_to_freeform_post";
+  createLandingPage: "create_landing_page_landing_pages_post";
+  createLandingPageAgentSession: "create_landing_page_agent_session_landing_pages__page_id__agent_sessions_post";
+  createLandingPagePreviewLink: "create_landing_page_preview_link_landing_pages__landing_page_id__preview_get";
+  deleteLandingPage: "delete_landing_page_landing_pages__landing_page_id__delete";
+  demoteLandingPageToTemplate: "demote_landing_page_to_template_landing_pages__landing_page_id__demote_to_template_post";
+  duplicateLandingPageTemplate: "duplicate_landing_page_template_landing_pages__landing_page_id__duplicate_post";
+  editLandingPageElement: "edit_landing_page_element_landing_pages__landing_page_id__edit_element_post";
+  editLandingPageWhole: "edit_landing_page_whole_landing_pages__landing_page_id__edit_page_post";
+  editLandingPageWithChat: "edit_landing_page_with_chat_landing_pages__landing_page_id__edit_post";
+  ensureLandingPageBaseTemplate: "ensure_landing_page_base_template_landing_pages_ensure_base_template_post";
+  exportLandingPage: "export_landing_page_landing_pages__landing_page_id__export_get";
+  extractLandingPageComponents: "extract_landing_page_components_landing_pages_components_extract_post";
+  fixLandingPageFindingWithAi: "fix_landing_page_finding_with_ai_landing_pages__landing_page_id__ai_review_fix_with_ai_post";
+  generateLandingPageSeoMetadata: "generate_landing_page_seo_metadata_landing_pages__landing_page_id__generate_seo_metadata_post";
+  getLandingPage: "get_landing_page_landing_pages__landing_page_id__get";
+  getLandingPageConsentDefault: "get_landing_page_consent_default_landing_page_consent_default_get";
+  getLandingPageConversation: "get_landing_page_conversation_landing_pages__landing_page_id__conversation_get";
+  getLandingPageDesignSystem: "get_landing_page_design_system_landing_pages_design_system_get";
+  getLandingPageManifest: "get_landing_page_manifest_landing_pages__landing_page_id__manifest_get";
+  getLandingPageReportingOverview: "get_landing_page_reporting_overview_landing_pages_reporting_overview_get";
+  getLandingPageSource: "get_landing_page_source_landing_pages_agent_sessions__session_id__get";
+  getLandingPageStatus: "get_landing_page_status_landing_pages__landing_page_id__status_get";
+  getLandingPageTracking: "get_landing_page_tracking_landing_pages__landing_page_id__tracking_get";
+  importLandingPageHtml: "import_landing_page_html_landing_pages__landing_page_id__import_html_post";
+  listLandingPageAnchors: "list_landing_page_anchors_landing_pages__landing_page_id__anchors_get";
+  listLandingPageBindings: "list_landing_page_bindings_landing_pages__landing_page_id__bindings_get";
+  listLandingPageComponents: "list_landing_page_components_landing_pages_components_get";
+  listLandingPageConsentStatus: "list_landing_page_consent_status_landing_page_consent_pages_get";
+  listLandingPageDomains: "list_landing_page_domains_landing_pages_domains_get";
+  listLandingPageReportingCompanies: "list_landing_page_reporting_companies_landing_pages_reporting_companies_get";
+  listLandingPageReportingPeople: "list_landing_page_reporting_people_landing_pages_reporting_people_get";
+  listLandingPageVersions: "list_landing_page_versions_landing_pages__landing_page_id__versions_get";
+  listLandingPages: "list_landing_pages_landing_pages_get";
+  patchLandingPage: "patch_landing_page_landing_pages_agent_sessions__session_id__patch_post";
+  promoteLandingPageTemplate: "promote_landing_page_template_landing_pages__landing_page_id__promote_to_page_post";
+  provisionLandingPageTracking: "provision_landing_page_tracking_landing_pages__landing_page_id__tracking_provision_post";
+  publishLandingPage: "publish_landing_page_landing_pages__landing_page_id__publish_post";
+  removeLandingPageBinding: "remove_landing_page_binding_landing_pages__landing_page_id__bindings_delete";
+  replaceLandingPageHtml: "replace_landing_page_html_landing_pages__landing_page_id__replace_html_post";
+  restoreLandingPageVersion: "restore_landing_page_version_landing_pages__landing_page_id__versions__version_num__restore_post";
+  reviewLandingPage: "review_landing_page_landing_pages__landing_page_id__ai_review_post";
+  rewriteLandingPageText: "rewrite_landing_page_text_landing_pages__landing_page_id__rewrite_text_post";
+  saveLandingPageTemplateAsPage: "save_landing_page_template_as_page_landing_pages__landing_page_id__save_as_page_post";
+  setLandingPageConsentDefault: "set_landing_page_consent_default_landing_page_consent_default_put";
+  setLandingPageMedia: "set_landing_page_media_landing_pages__landing_page_id__set_media_edit_post";
+  setLandingPageText: "set_landing_page_text_landing_pages__landing_page_id__set_text_post";
+  unpublishLandingPage: "unpublish_landing_page_landing_pages__landing_page_id__unpublish_post";
+  updateLandingPage: "update_landing_page_landing_pages__landing_page_id__patch";
+  updateLandingPageHtml: "update_landing_page_html_landing_pages__landing_page_id__update_html_post";
+  updateLandingPageSection: "update_landing_page_section_landing_pages__landing_page_id__sections__section_idx__patch";
+  updateLandingPageText: "update_landing_page_text_landing_pages__landing_page_id__update_text_post";
+  updateLandingPageTracking: "update_landing_page_tracking_landing_pages__landing_page_id__tracking_patch";
+}
+
+/** Input and output of every `g8.api.landingPages` operation, keyed by operationId. */
+export interface LandingPagesOperations {
+  /**
+   * POST /landing-pages/{landing_page_id}/ai-review/apply
+   * Apply Landing Page Review Findings
+   * tier: write · scope: campaigns:write
+   */
+  apply_landing_page_review_findings_landing_pages__landing_page_id__ai_review_apply_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIReviewApplyRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /landing-pages/{landing_page_id}/approve-template
+   * Approve Landing Page Template
+   * tier: write · scope: campaigns:write
+   */
+  approve_landing_page_template_landing_pages__landing_page_id__approve_template_patch: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /landing-pages/{landing_page_id}/tracking/consent
+   * Clear Landing Page Consent Override
+   * tier: destructive · scope: campaigns:delete
+   */
+  clear_landing_page_consent_override_landing_pages__landing_page_id__tracking_consent_delete: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/clone-homepage
+   * Clone Homepage To Landing Page
+   * tier: billable · scope: campaigns:run
+   */
+  clone_homepage_to_landing_page_landing_pages_clone_homepage_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CloneHomepageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/clone-html
+   * Clone Html To Landing Page
+   * tier: billable · scope: campaigns:run
+   */
+  clone_html_to_landing_page_landing_pages_clone_html_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CloneHtmlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/clone-url
+   * Clone Url To Landing Page
+   * tier: billable · scope: campaigns:run
+   */
+  clone_url_to_landing_page_landing_pages_clone_url_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CloneUrlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/convert-to-freeform
+   * Convert Landing Page To Freeform
+   * tier: write · scope: campaigns:write
+   */
+  convert_landing_page_to_freeform_landing_pages__landing_page_id__convert_to_freeform_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages
+   * Create Landing Page
+   * tier: billable · scope: campaigns:run
+   */
+  create_landing_page_landing_pages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateLandingPageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{page_id}/agent-sessions
+   * Create Landing Page Agent Session
+   * tier: write · scope: integrations:write
+   */
+  create_landing_page_agent_session_landing_pages__page_id__agent_sessions_post: {
+    input: {
+    path: {
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: CreateAgentSessionRequest | null;
+  };
+    output: ApiResponse_dict_str__Any__;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/preview
+   * Create Landing Page Preview Link
+   * tier: read · scope: campaigns:read
+   */
+  create_landing_page_preview_link_landing_pages__landing_page_id__preview_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /landing-pages/{landing_page_id}
+   * Delete Landing Page
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_landing_page_landing_pages__landing_page_id__delete: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/demote-to-template
+   * Demote Landing Page To Template
+   * tier: write · scope: campaigns:write
+   */
+  demote_landing_page_to_template_landing_pages__landing_page_id__demote_to_template_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/duplicate
+   * Duplicate Landing Page Template
+   * tier: write · scope: campaigns:write
+   */
+  duplicate_landing_page_template_landing_pages__landing_page_id__duplicate_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DuplicateTemplateRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/edit-element
+   * Edit Landing Page Element
+   * tier: billable · scope: campaigns:run
+   */
+  edit_landing_page_element_landing_pages__landing_page_id__edit_element_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EditElementRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/edit-page
+   * Edit Landing Page Whole
+   * tier: billable · scope: campaigns:run
+   */
+  edit_landing_page_whole_landing_pages__landing_page_id__edit_page_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EditWithChatRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/edit
+   * Edit Landing Page With Chat
+   * tier: billable · scope: campaigns:run
+   */
+  edit_landing_page_with_chat_landing_pages__landing_page_id__edit_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EditWithChatRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/ensure-base-template
+   * Ensure Landing Page Base Template
+   * tier: billable · scope: campaigns:run
+   */
+  ensure_landing_page_base_template_landing_pages_ensure_base_template_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/export
+   * Export Landing Page
+   * tier: read · scope: campaigns:read
+   */
+  export_landing_page_landing_pages__landing_page_id__export_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/components/extract
+   * Extract Landing Page Components
+   * tier: billable · scope: campaigns:run
+   */
+  extract_landing_page_components_landing_pages_components_extract_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/ai-review/fix-with-ai
+   * Fix Landing Page Finding With Ai
+   * tier: billable · scope: campaigns:run
+   */
+  fix_landing_page_finding_with_ai_landing_pages__landing_page_id__ai_review_fix_with_ai_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIReviewFixWithAIRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/generate-seo-metadata
+   * Generate Landing Page Seo Metadata
+   * tier: billable · scope: campaigns:run
+   */
+  generate_landing_page_seo_metadata_landing_pages__landing_page_id__generate_seo_metadata_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}
+   * Get Landing Page
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_landing_pages__landing_page_id__get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-page-consent/default
+   * Get Landing Page Consent Default
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_consent_default_landing_page_consent_default_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/conversation
+   * Get Landing Page Conversation
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_conversation_landing_pages__landing_page_id__conversation_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/design-system
+   * Get Landing Page Design System
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_design_system_landing_pages_design_system_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/manifest
+   * Get Landing Page Manifest
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_manifest_landing_pages__landing_page_id__manifest_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/reporting/overview
+   * Get Landing Page Reporting Overview
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_reporting_overview_landing_pages_reporting_overview_get: {
+    input: {
+    query?: {
+      /** Look-back window in days. */
+      days?: number;
+      /** Only these pages. Repeat the parameter. */
+      page_id?: Array<string> | null;
+      /** Traffic source. */
+      source?: "all" | "paid" | "email" | "organic" | "referral" | "direct";
+      /** Only this UTM campaign. */
+      observed_campaign?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/agent-sessions/{session_id}
+   * Get Landing Page Source
+   * tier: read · scope: landing-pages:read
+   */
+  get_landing_page_source_landing_pages_agent_sessions__session_id__get: {
+    input: {
+    path: {
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_str__Any__;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/status
+   * Get Landing Page Status
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_status_landing_pages__landing_page_id__status_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/tracking
+   * Get Landing Page Tracking
+   * tier: read · scope: campaigns:read
+   */
+  get_landing_page_tracking_landing_pages__landing_page_id__tracking_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/import-html
+   * Import Landing Page Html
+   * tier: write · scope: campaigns:write
+   */
+  import_landing_page_html_landing_pages__landing_page_id__import_html_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ImportHtmlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/anchors
+   * List Landing Page Anchors
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_anchors_landing_pages__landing_page_id__anchors_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/bindings
+   * List Landing Page Bindings
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_bindings_landing_pages__landing_page_id__bindings_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/components
+   * List Landing Page Components
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_components_landing_pages_components_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-page-consent/pages
+   * List Landing Page Consent Status
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_consent_status_landing_page_consent_pages_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/domains
+   * List Landing Page Domains
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_domains_landing_pages_domains_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/reporting/companies
+   * List Landing Page Reporting Companies
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_reporting_companies_landing_pages_reporting_companies_get: {
+    input: {
+    query?: {
+      cursor?: number;
+      limit?: number;
+      /** Look-back window in days. */
+      days?: number;
+      /** Only these pages. Repeat the parameter. */
+      page_id?: Array<string> | null;
+      /** Traffic source. */
+      source?: "all" | "paid" | "email" | "organic" | "referral" | "direct";
+      /** Only this UTM campaign. */
+      observed_campaign?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/reporting/people
+   * List Landing Page Reporting People
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_reporting_people_landing_pages_reporting_people_get: {
+    input: {
+    query?: {
+      cursor?: number;
+      limit?: number;
+      /** Look-back window in days. */
+      days?: number;
+      /** Only these pages. Repeat the parameter. */
+      page_id?: Array<string> | null;
+      /** Traffic source. */
+      source?: "all" | "paid" | "email" | "organic" | "referral" | "direct";
+      /** Only this UTM campaign. */
+      observed_campaign?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages/{landing_page_id}/versions
+   * List Landing Page Versions
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_page_versions_landing_pages__landing_page_id__versions_get: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /landing-pages
+   * List Landing Pages
+   * tier: read · scope: campaigns:read
+   */
+  list_landing_pages_landing_pages_get: {
+    input: {
+    query?: {
+      /** Filter by page status (draft, published, ...). */
+      status?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /landing-pages/agent-sessions/{session_id}/patch
+   * Patch Landing Page
+   * tier: write · scope: landing-pages:write
+   */
+  patch_landing_page_landing_pages_agent_sessions__session_id__patch_post: {
+    input: {
+    path: {
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPagePatchRequest;
+  };
+    output: ApiResponse_dict_str__Any__;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/promote-to-page
+   * Promote Landing Page Template
+   * tier: write · scope: campaigns:write
+   */
+  promote_landing_page_template_landing_pages__landing_page_id__promote_to_page_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/tracking/provision
+   * Provision Landing Page Tracking
+   * tier: write · scope: campaigns:write
+   */
+  provision_landing_page_tracking_landing_pages__landing_page_id__tracking_provision_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/publish
+   * Publish Landing Page
+   * tier: external · scope: campaigns:run
+   */
+  publish_landing_page_landing_pages__landing_page_id__publish_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: PublishLandingPageRequest | null;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /landing-pages/{landing_page_id}/bindings
+   * Remove Landing Page Binding
+   * tier: destructive · scope: campaigns:delete
+   */
+  remove_landing_page_binding_landing_pages__landing_page_id__bindings_delete: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    query: {
+      /** The host to stop serving this page at. */
+      hostname: string;
+      /** The path under that host. Defaults to the root. */
+      path?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/replace-html
+   * Replace Landing Page Html
+   * tier: write · scope: campaigns:write
+   */
+  replace_landing_page_html_landing_pages__landing_page_id__replace_html_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ReplaceHtmlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/versions/{version_num}/restore
+   * Restore Landing Page Version
+   * tier: write · scope: campaigns:write
+   */
+  restore_landing_page_version_landing_pages__landing_page_id__versions__version_num__restore_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+      /** Version number, from `GET .../versions`. */
+      version_num: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/ai-review
+   * Review Landing Page
+   * tier: billable · scope: campaigns:run
+   */
+  review_landing_page_landing_pages__landing_page_id__ai_review_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: AIReviewRequest | null;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/rewrite-text
+   * Rewrite Landing Page Text
+   * tier: billable · scope: campaigns:run
+   */
+  rewrite_landing_page_text_landing_pages__landing_page_id__rewrite_text_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPageRewriteTextRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/save-as-page
+   * Save Landing Page Template As Page
+   * tier: write · scope: campaigns:write
+   */
+  save_landing_page_template_as_page_landing_pages__landing_page_id__save_as_page_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PUT /landing-page-consent/default
+   * Set Landing Page Consent Default
+   * tier: write · scope: campaigns:write
+   */
+  set_landing_page_consent_default_landing_page_consent_default_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPageConsentConfig;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/set-media-edit
+   * Set Landing Page Media
+   * tier: write · scope: campaigns:write
+   */
+  set_landing_page_media_landing_pages__landing_page_id__set_media_edit_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPageSetMediaEditRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/set-text
+   * Set Landing Page Text
+   * tier: write · scope: campaigns:write
+   */
+  set_landing_page_text_landing_pages__landing_page_id__set_text_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPageSetTextRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/unpublish
+   * Unpublish Landing Page
+   * tier: external · scope: campaigns:run
+   */
+  unpublish_landing_page_landing_pages__landing_page_id__unpublish_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /landing-pages/{landing_page_id}
+   * Update Landing Page
+   * tier: write · scope: campaigns:write
+   */
+  update_landing_page_landing_pages__landing_page_id__patch: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateLandingPageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/update-html
+   * Update Landing Page Html
+   * tier: write · scope: campaigns:write
+   */
+  update_landing_page_html_landing_pages__landing_page_id__update_html_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateHtmlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /landing-pages/{landing_page_id}/sections/{section_idx}
+   * Update Landing Page Section
+   * tier: write · scope: campaigns:write
+   */
+  update_landing_page_section_landing_pages__landing_page_id__sections__section_idx__patch: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+      /** Zero-based section index. */
+      section_idx: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateSectionRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /landing-pages/{landing_page_id}/update-text
+   * Update Landing Page Text
+   * tier: write · scope: campaigns:write
+   */
+  update_landing_page_text_landing_pages__landing_page_id__update_text_post: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateTextRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /landing-pages/{landing_page_id}/tracking
+   * Update Landing Page Tracking
+   * tier: write · scope: campaigns:write
+   */
+  update_landing_page_tracking_landing_pages__landing_page_id__tracking_patch: {
+    input: {
+    path: {
+      /** Landing page id. */
+      landing_page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LandingPageTrackingPatchRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+}
+
+// 34 schemas referenced above (the same as G8Contract.<Name>).
+
+/** Apply findings DETERMINISTICALLY. Spends nothing - no model runs. */
+export interface AIReviewApplyRequest {
+  finding_ids: Array<string>;
+}
+
+/** Send ONE finding to the edit engine. SPENDS CREDIT. */
+export interface AIReviewFixWithAIRequest {
+  brand_mode?: string | null;
+  finding: Record<string, unknown>;
+}
+
+/**
+ * Run a review pass over the page. SPENDS CREDIT.
+ *
+ * `deep` defaults TRUE, matching the app - the deeper pass is the one worth
+ * running, and quietly defaulting to the cheap one here would make the same
+ * call behave differently through the API than in Studio.
+ */
+export interface AIReviewRequest {
+  deep?: boolean;
+}
+
+export interface ApiResponse_StudioContentListPayload_ {
+  data: StudioContentListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioContentPayload_ {
+  data: StudioContentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_str__Any__ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+/** Clone the org's own homepage into an editable page. SPENDS CREDIT. */
+export interface CloneHomepageRequest {
+  description?: string | null;
+  goal?: string | null;
+  name?: string | null;
+  use_vision?: boolean;
+}
+
+/**
+ * Clone from raw source the caller already has. SPENDS CREDIT.
+ *
+ * `use_vision` defaults OFF here, unlike `/clone-url`: there is no live page
+ * to screenshot, so the extra pass buys much less.
+ */
+export interface CloneHtmlRequest {
+  /** Original filename - drives format detection (e.g. dialer.astro). */
+  filename?: string | null;
+  html: string;
+  name?: string | null;
+  source_url?: string | null;
+  use_vision?: boolean;
+}
+
+/**
+ * Clone any public URL into an editable page. SPENDS CREDIT.
+ *
+ * It fetches the page and runs an extraction pass; `use_vision` adds a
+ * multimodal pass on a screenshot, which costs more and is the default
+ * because it is what makes the clone usable.
+ */
+export interface CloneUrlRequest {
+  name?: string | null;
+  url: string;
+  /** Multimodal pass. Costs more. Default on. */
+  use_vision?: boolean;
+}
+
+/** How the agent wants its edits handled once it starts patching. */
+export interface CreateAgentSessionRequest {
+  /** '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. */
+  approval_mode?: string;
+}
+
+/**
+ * Create a landing page. SPENDS CREDIT when `generate` is true.
+ *
+ * `generate` true (the default) runs the full generation pass - copy, layout
+ * and imagery - against the org's brand context. Send `generate: false` for
+ * an empty shell you intend to fill with `/clone-url`, `/import-html` or the
+ * deterministic edit routes, and nothing is spent.
+ */
+export interface CreateLandingPageRequest {
+  campaign_id?: string | null;
+  /** Run the AI generation pass. TRUE BY DEFAULT and it spends credit. */
+  generate?: boolean;
+  generation_mode?: string | null;
+  goal?: string | null;
+  name?: string | null;
+}
+
+/** Duplicate a Brand Kit template as another template. Spends nothing. */
+export interface DuplicateTemplateRequest {
+  name?: string | null;
+}
+
+/** Edit one element by CSS selector. SPENDS CREDIT - it is an LLM pass. */
+export interface EditElementRequest {
+  instruction: string;
+  selector: string;
+}
+
+/** A natural-language edit instruction. SPENDS CREDIT - it is an LLM pass. */
+export interface EditWithChatRequest {
+  instruction: string;
+  section_idx?: number | null;
+  selected_text?: string | null;
+}
+
+/** One exact replacement applied against the evolving HTML document. */
+export interface ExactReplacementRequest {
+  expected_matches?: number;
+  new: string;
+  old: string;
+}
+
+/**
+ * Import externally edited HTML into a draft. Spends nothing.
+ *
+ * `commit` false is a DRY RUN that reports what the import would change.
+ * `reassign_g8_ids` renumbers the element ids every other edit route
+ * addresses, which invalidates ids a caller is holding - the app requires
+ * `confirm_action_rebuild` alongside it for exactly that reason.
+ */
+export interface ImportHtmlRequest {
+  /** False previews; true writes the draft. */
+  commit?: boolean;
+  confirm_action_rebuild?: boolean;
+  html: string;
+  reassign_g8_ids?: boolean;
+  reinfer_button_actions?: boolean;
+  strip_vendor_css?: boolean;
+}
+
+/** The cookie-consent gate on a published landing page. */
+export interface LandingPageConsentConfig {
+  /** Hex colour. */
+  accent?: string;
+  accept_label?: string;
+  /** False when your own consent manager drives the gate. */
+  banner?: boolean;
+  message?: string;
+  mode?: "off" | "explicit" | "region";
+  policy_label?: string;
+  policy_url?: string | null;
+  /** Only used when mode is `region`. */
+  regions?: Array<"EEA">;
+  reject_label?: string;
+  reopener?: boolean;
+  reopener_label?: string;
+  title?: string;
+  /** Bump to re-prompt every visitor. */
+  version?: number;
+}
+
+/** Conflict-safe, idempotent landing-page patch request. */
+export interface LandingPagePatchRequest {
+  base_sha256: string;
+  idempotency_key: string;
+  replacements: Array<ExactReplacementRequest>;
+  summary?: string;
+}
+
+/**
+ * Rewrite one element's text with AI. SPENDS CREDIT.
+ *
+ * Text only - it never regenerates HTML, which is what makes it the cheap
+ * half of the pair with `/edit`.
+ */
+export interface LandingPageRewriteTextRequest {
+  instruction: string;
+  selected_element: SelectedElementPayload;
+}
+
+/**
+ * Deterministically change one `<img>` / `<video>`. Spends nothing.
+ *
+ * `remove` true deletes the element rather than editing it, so it is the one
+ * destructive field in the body.
+ */
+export interface LandingPageSetMediaEditRequest {
+  alt?: string | null;
+  autoplay?: boolean | null;
+  controls?: boolean | null;
+  g8_action_id: string;
+  kind: "img" | "video";
+  loop?: boolean | null;
+  muted?: boolean | null;
+  object_fit?: ("cover" | "contain" | "fill" | "none" | "scale-down") | null;
+  object_position?: string | null;
+  position?: MediaPosition | null;
+  poster?: string | null;
+  remove?: boolean;
+  src?: string | null;
+}
+
+/** Set the visible text of one element. Deterministic, spends nothing. */
+export interface LandingPageSetTextRequest {
+  element_id: string;
+  new_text: string;
+  selected_element?: SelectedElementPayload | null;
+}
+
+/** Partial update of a page's tracking. Only the fields you send change. */
+export interface LandingPageTrackingPatchRequest {
+  chat_enabled?: boolean | null;
+  consent?: LandingPageConsentConfig | null;
+  conversion_goal?: ("form_submission" | "workspace_signup" | "paid_account" | "traffic_only") | null;
+  form_id?: string | null;
+  /** `dedicated` is reached through `/tracking/provision`, not here. */
+  mode?: ("org_default" | "dedicated" | "disabled") | null;
+}
+
+/** Per-breakpoint drag offsets. `desktop` is required; the rest inherit. */
+export interface MediaPosition {
+  desktop: MediaPositionOffset;
+  mobile?: MediaPositionOffset | null;
+  tablet?: MediaPositionOffset | null;
+}
+
+/** One breakpoint's drag offset, in pixels. */
+export interface MediaPositionOffset {
+  x?: number;
+  y?: number;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * Where to publish. Every field optional - omit for the page's own slug.
+ *
+ * `override` true takes a URL that is already bound to a DIFFERENT page.
+ * That page stops serving at it. Left false, a collision is refused.
+ */
+export interface PublishLandingPageRequest {
+  domain?: string | null;
+  domain_id?: number | null;
+  /** Steal a URL already bound to another page. Default false. */
+  override?: boolean;
+  path?: string | null;
+  slug?: string | null;
+  subdomain?: string | null;
+}
+
+/** Persist a whole-page HTML snapshot. Deterministic, spends nothing. */
+export interface ReplaceHtmlRequest {
+  edit_instruction?: string | null;
+  html: string;
+}
+
+/** What the visual picker selected, as the rewrite pass needs to see it. */
+export interface SelectedElementPayload {
+  element_id: string;
+  outer_html?: string | null;
+  role?: string | null;
+  scope?: string;
+  section_id?: string | null;
+  tag: string;
+  text?: string | null;
+}
+
+/**
+ * A LIST result, open-shaped, with `items` always present.
+ *
+ * The app returns a bare list from some routes and a named key from others
+ * (`pages`, `grids`, `images`, `creatives`, `reports`, `items`). Both are
+ * published: the original key is preserved AND mirrored onto `items`, so a
+ * client can page any Studio collection the same way without a per-route
+ * lookup table.
+ */
+export interface StudioContentListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** One Studio object, open-shaped. See the module docstring. */
+export type StudioContentPayload = Record<string, unknown>;
+
+/** Raw HTML save from the code editor. Deterministic, spends nothing. */
+export interface UpdateHtmlRequest {
+  html: string;
+}
+
+/** Metadata only - name, slug, description, settings. Spends nothing. */
+export interface UpdateLandingPageRequest {
+  description?: string | null;
+  name?: string | null;
+  settings?: Record<string, unknown> | null;
+  slug?: string | null;
+}
+
+/** Replace one section's content block. Deterministic, spends nothing. */
+export interface UpdateSectionRequest {
+  content: Record<string, unknown>;
+}
+
+/** Set one element's inner HTML directly. No AI, spends nothing. */
+export interface UpdateTextRequest {
+  element_id: string;
+  new_html: string;
+}