@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/newsletter.d.ts

@@ -0,0 +1,1613 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.newsletter` (Newsletter): 61 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"activate_newsletter_newsletters__newsletter_id__activate_post">;
+ *
+ * Reference with examples: newsletter.md
+ */
+/* eslint-disable */
+
+/** `g8.api.newsletter.<member>` -> the operationId it calls. */
+export interface NewsletterMembers {
+  activateNewsletter: "activate_newsletter_newsletters__newsletter_id__activate_post";
+  addSubscriber: "add_subscriber_newsletters__newsletter_id__subscribers_post";
+  batchTemplateGenerationStatus: "batch_template_generation_status_newsletters_templates_generation_status_post";
+  cancelSend: "cancel_send_newsletters__newsletter_id__issues__issue_id__send_cancel_post";
+  cloneTemplate: "clone_template_newsletters_templates_clone_post";
+  completeNewsletter: "complete_newsletter_newsletters__newsletter_id__complete_post";
+  createIssue: "create_issue_newsletters__newsletter_id__issues_post";
+  createNewsletter: "create_newsletter_newsletters_post";
+  createTemplateFromLayout: "create_template_from_layout_newsletters_templates_layout_post";
+  createTemplateFromPrompt: "create_template_from_prompt_newsletters_templates_custom_post";
+  deleteIssue: "delete_issue_newsletters__newsletter_id__issues__issue_id__delete";
+  deleteNewsletterTemplate: "delete_newsletter_template_newsletters_templates__template_id__delete";
+  deleteSubscriber: "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete";
+  disableNewsletterListSync: "disable_newsletter_list_sync_newsletters__newsletter_id__list_syncs__audience_list_id__delete";
+  duplicateIssue: "duplicate_issue_newsletters__newsletter_id__issues__issue_id__duplicate_post";
+  enableNewsletterListSync: "enable_newsletter_list_sync_newsletters__newsletter_id__list_syncs_post";
+  generateNewsletterIssue: "generate_newsletter_issue_newsletters__newsletter_id__issues__issue_id__generate_post";
+  getIssue: "get_issue_newsletters__newsletter_id__issues__issue_id__get";
+  getIssueAnalyticsKpis: "get_issue_analytics_kpis_newsletters__newsletter_id__issues__issue_id__analytics_kpis_get";
+  getIssueGenerationStatus: "get_issue_generation_status_newsletters__newsletter_id__issues__issue_id__generation_status_get";
+  getNewsletter: "get_newsletter_newsletters__newsletter_id__get";
+  getNewsletterIssueConversation: "get_newsletter_issue_conversation_newsletters__newsletter_id__issues__issue_id__conversation_get";
+  getNewsletterSettings: "get_newsletter_settings_newsletters__newsletter_id__settings_get";
+  getNewsletterSubscriberVerification: "get_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_status_get";
+  getSendStatus: "get_send_status_newsletters__newsletter_id__issues__issue_id__send_get";
+  getSubscriberTimeline: "get_subscriber_timeline_newsletters__newsletter_id__issues__issue_id__analytics_subscribers__subscriber_id__timeline_get";
+  importSubscribersFromAudience: "import_subscribers_from_audience_newsletters__newsletter_id__subscribers_import_audience_post";
+  linkNewsletterCampaign: "link_newsletter_campaign_newsletters__newsletter_id__campaign_put";
+  listIssues: "list_issues_newsletters__newsletter_id__issues_get";
+  listNewsletterIssueVersions: "list_newsletter_issue_versions_newsletters__newsletter_id__issues__issue_id__versions_get";
+  listNewsletterListSyncs: "list_newsletter_list_syncs_newsletters__newsletter_id__list_syncs_get";
+  listNewsletters: "list_newsletters_newsletters_get";
+  listSubscribers: "list_subscribers_newsletters__newsletter_id__subscribers_get";
+  listTemplates: "list_templates_newsletters_templates_get";
+  newsletterDomainStatus: "newsletter_domain_status_newsletters__newsletter_id__settings_domain_status_get";
+  pauseNewsletter: "pause_newsletter_newsletters__newsletter_id__pause_post";
+  pauseSend: "pause_send_newsletters__newsletter_id__issues__issue_id__send_pause_post";
+  previewNewsletterSubscriberVerification: "preview_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_preview_post";
+  restoreNewsletterIssueVersion: "restore_newsletter_issue_version_newsletters__newsletter_id__issues__issue_id__versions__version_num__restore_post";
+  resumeNewsletter: "resume_newsletter_newsletters__newsletter_id__resume_post";
+  resumeSend: "resume_send_newsletters__newsletter_id__issues__issue_id__send_resume_post";
+  rewriteIssueText: "rewrite_issue_text_newsletters__newsletter_id__issues__issue_id__rewrite_text_post";
+  runNewsletterListSync: "run_newsletter_list_sync_newsletters__newsletter_id__list_syncs__audience_list_id__run_post";
+  sendIssue: "send_issue_newsletters__newsletter_id__issues__issue_id__send_post";
+  sendTestEmail: "send_test_email_newsletters__newsletter_id__issues__issue_id__send_test_post";
+  setIssueButtonAction: "set_issue_button_action_newsletters__newsletter_id__issues__issue_id__set_button_action_post";
+  setIssueMediaEdit: "set_issue_media_edit_newsletters__newsletter_id__issues__issue_id__set_media_edit_post";
+  setIssueText: "set_issue_text_newsletters__newsletter_id__issues__issue_id__set_text_post";
+  setTemplateApproval: "set_template_approval_newsletters_templates__template_id__approval_post";
+  setTemplateButtonAction: "set_template_button_action_newsletters_templates__template_id__set_button_action_post";
+  setTemplateMediaEdit: "set_template_media_edit_newsletters_templates__template_id__set_media_edit_post";
+  templateGenerationStatus: "template_generation_status_newsletters_templates__template_id__generation_status_get";
+  unlinkNewsletterCampaign: "unlink_newsletter_campaign_newsletters__newsletter_id__campaign_delete";
+  unsubscribeSubscriber: "unsubscribe_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__unsubscribe_patch";
+  updateIssue: "update_issue_newsletters__newsletter_id__issues__issue_id__put";
+  updateNewsletter: "update_newsletter_newsletters__newsletter_id__patch";
+  updateNewsletterSettings: "update_newsletter_settings_newsletters__newsletter_id__settings_put";
+  updateNewsletterTemplate: "update_newsletter_template_newsletters_templates__template_id__patch";
+  useTemplate: "use_template_newsletters_templates__template_id__use_post";
+  verifyNewsletterDomain: "verify_newsletter_domain_newsletters__newsletter_id__settings_verify_domain_post";
+  verifyNewsletterSubscribers: "verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post";
+}
+
+/** Input and output of every `g8.api.newsletter` operation, keyed by operationId. */
+export interface NewsletterOperations {
+  /**
+   * POST /newsletters/{newsletter_id}/activate
+   * Activate Newsletter
+   * tier: external · scope: newsletter:run
+   */
+  activate_newsletter_newsletters__newsletter_id__activate_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/subscribers
+   * Add Subscriber
+   * tier: external · scope: newsletter:run
+   */
+  add_subscriber_newsletters__newsletter_id__subscribers_post: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SubscriberAddRequest;
+  };
+    output: ApiResponse_SubscriberSummary_;
+  };
+  /**
+   * POST /newsletters/templates/generation-status
+   * Batch Template Generation Status
+   * tier: read · scope: newsletter:read
+   */
+  batch_template_generation_status_newsletters_templates_generation_status_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TemplateGenerationStatusBatchRequest;
+  };
+    output: ApiResponse_NewsletterListPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/send/cancel
+   * Cancel Send
+   * tier: write · scope: newsletter:write
+   */
+  cancel_send_newsletters__newsletter_id__issues__issue_id__send_cancel_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SendControlRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/templates/clone
+   * Clone Template
+   * tier: billable · scope: newsletter:run
+   */
+  clone_template_newsletters_templates_clone_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TemplateCloneRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/complete
+   * Complete Newsletter
+   * tier: write · scope: newsletter:write
+   */
+  complete_newsletter_newsletters__newsletter_id__complete_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStatusResponse_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues
+   * Create Issue
+   * tier: external · scope: newsletter:run
+   */
+  create_issue_newsletters__newsletter_id__issues_post: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: IssueCreateRequest;
+  };
+    output: ApiResponse_IssueDetail_;
+  };
+  /**
+   * POST /newsletters
+   * Create Newsletter
+   * tier: external · scope: newsletter:run
+   */
+  create_newsletter_newsletters_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: NewsletterCreateRequest;
+  };
+    output: ApiResponse_NewsletterDetail_;
+  };
+  /**
+   * POST /newsletters/templates/layout
+   * Create Template From Layout
+   * tier: billable · scope: newsletter:run
+   */
+  create_template_from_layout_newsletters_templates_layout_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TemplateFromLayoutRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/templates/custom
+   * Create Template From Prompt
+   * tier: billable · scope: newsletter:run
+   */
+  create_template_from_prompt_newsletters_templates_custom_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TemplateFromPromptRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * DELETE /newsletters/{newsletter_id}/issues/{issue_id}
+   * Delete Issue
+   * tier: destructive · scope: newsletter:delete
+   */
+  delete_issue_newsletters__newsletter_id__issues__issue_id__delete: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * DELETE /newsletters/templates/{template_id}
+   * Delete Newsletter Template
+   * tier: destructive · scope: newsletter:delete
+   */
+  delete_newsletter_template_newsletters_templates__template_id__delete: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * DELETE /newsletters/{newsletter_id}/subscribers/{subscriber_id}
+   * Delete Subscriber
+   * tier: destructive · scope: newsletter:delete
+   */
+  delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Subscriber id. */
+      subscriber_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * DELETE /newsletters/{newsletter_id}/list-syncs/{audience_list_id}
+   * Disable Newsletter List Sync
+   * tier: destructive · scope: newsletter:delete
+   */
+  disable_newsletter_list_sync_newsletters__newsletter_id__list_syncs__audience_list_id__delete: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Audience list id. */
+      audience_list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_Any_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/duplicate
+   * Duplicate Issue
+   * tier: external · scope: newsletter:run
+   */
+  duplicate_issue_newsletters__newsletter_id__issues__issue_id__duplicate_post: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Source issue id (any status) */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IssueDetail_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/list-syncs
+   * Enable Newsletter List Sync
+   * tier: write · scope: newsletter:write
+   */
+  enable_newsletter_list_sync_newsletters__newsletter_id__list_syncs_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ListSyncEnableRequest;
+  };
+    output: ApiResponse_Any_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/generate
+   * Generate Newsletter Issue
+   * tier: billable · scope: newsletter:run
+   */
+  generate_newsletter_issue_newsletters__newsletter_id__issues__issue_id__generate_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: NewsletterIssueGenerateRequest;
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}
+   * Get Issue
+   * tier: read · scope: newsletter:read
+   */
+  get_issue_newsletters__newsletter_id__issues__issue_id__get: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Issue id */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IssueDetail_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/analytics/kpis
+   * Get Issue Analytics Kpis
+   * tier: read · scope: newsletter:read
+   */
+  get_issue_analytics_kpis_newsletters__newsletter_id__issues__issue_id__analytics_kpis_get: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Issue id */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IssueAnalyticsKpis_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/generation-status
+   * Get Issue Generation Status
+   * tier: read · scope: newsletter:read
+   */
+  get_issue_generation_status_newsletters__newsletter_id__issues__issue_id__generation_status_get: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}
+   * Get Newsletter
+   * tier: read · scope: newsletter:read
+   */
+  get_newsletter_newsletters__newsletter_id__get: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterDetail_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/conversation
+   * Get Newsletter Issue Conversation
+   * tier: read · scope: newsletter:read
+   */
+  get_newsletter_issue_conversation_newsletters__newsletter_id__issues__issue_id__conversation_get: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/settings
+   * Get Newsletter Settings
+   * tier: read · scope: newsletter:read
+   */
+  get_newsletter_settings_newsletters__newsletter_id__settings_get: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/subscribers/verify/status
+   * Get Newsletter Subscriber Verification
+   * tier: read · scope: newsletter:read
+   */
+  get_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_status_get: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/send
+   * Get Send Status
+   * tier: read · scope: newsletter:read
+   */
+  get_send_status_newsletters__newsletter_id__issues__issue_id__send_get: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/analytics/subscribers/{subscriber_id}/timeline
+   * Get Subscriber Timeline
+   * tier: read · scope: newsletter:read
+   */
+  get_subscriber_timeline_newsletters__newsletter_id__issues__issue_id__analytics_subscribers__subscriber_id__timeline_get: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+      /** Subscriber id. */
+      subscriber_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/subscribers/import-audience
+   * Import Subscribers From Audience
+   * tier: billable · scope: newsletter:run
+   */
+  import_subscribers_from_audience_newsletters__newsletter_id__subscribers_import_audience_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ImportAudienceRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * PUT /newsletters/{newsletter_id}/campaign
+   * Link Newsletter Campaign
+   * tier: write · scope: newsletter:write
+   */
+  link_newsletter_campaign_newsletters__newsletter_id__campaign_put: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: NewsletterCampaignLinkRequest;
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues
+   * List Issues
+   * tier: read · scope: newsletter:read
+   */
+  list_issues_newsletters__newsletter_id__issues_get: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/issues/{issue_id}/versions
+   * List Newsletter Issue Versions
+   * tier: read · scope: newsletter:read
+   */
+  list_newsletter_issue_versions_newsletters__newsletter_id__issues__issue_id__versions_get: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/list-syncs
+   * List Newsletter List Syncs
+   * tier: read · scope: newsletter:read
+   */
+  list_newsletter_list_syncs_newsletters__newsletter_id__list_syncs_get: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    query?: {
+      /** Resolve a CANDIDATE list that has no saved row yet. Returns a synthetic disabled entry carrying the live name and count, so a rebuilt enable dialog can state the number the worker will actually act on rather than a stale one. */
+      audience_list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ListSyncListResponse_;
+  };
+  /**
+   * GET /newsletters
+   * List Newsletters
+   * tier: read · scope: newsletter:read
+   */
+  list_newsletters_newsletters_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/subscribers
+   * List Subscribers
+   * tier: read · scope: newsletter:read
+   */
+  list_subscribers_newsletters__newsletter_id__subscribers_get: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+    };
+    query?: {
+      page?: number;
+      page_size?: number;
+      /** Free-text search over email/name */
+      search?: string | null;
+      /** Comma-separated status filter (e.g. 'subscribed,bounced') */
+      status?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SubscriberListResponse_;
+  };
+  /**
+   * GET /newsletters/templates
+   * List Templates
+   * tier: read · scope: newsletter:read
+   */
+  list_templates_newsletters_templates_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_;
+  };
+  /**
+   * GET /newsletters/{newsletter_id}/settings/domain-status
+   * Newsletter Domain Status
+   * tier: read · scope: newsletter:read
+   */
+  newsletter_domain_status_newsletters__newsletter_id__settings_domain_status_get: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    query: {
+      /** The domain to check. */
+      domain: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/pause
+   * Pause Newsletter
+   * tier: write · scope: newsletter:write
+   */
+  pause_newsletter_newsletters__newsletter_id__pause_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStatusResponse_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/send/pause
+   * Pause Send
+   * tier: write · scope: newsletter:write
+   */
+  pause_send_newsletters__newsletter_id__issues__issue_id__send_pause_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SendControlRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/subscribers/verify/preview
+   * Preview Newsletter Subscriber Verification
+   * tier: read · scope: newsletter:read
+   */
+  preview_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_preview_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/versions/{version_num}/restore
+   * Restore Newsletter Issue Version
+   * tier: write · scope: newsletter:write
+   */
+  restore_newsletter_issue_version_newsletters__newsletter_id__issues__issue_id__versions__version_num__restore_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+      /** The version to restore. */
+      version_num: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/resume
+   * Resume Newsletter
+   * tier: external · scope: newsletter:run
+   */
+  resume_newsletter_newsletters__newsletter_id__resume_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/send/resume
+   * Resume Send
+   * tier: external · scope: newsletter:run
+   */
+  resume_send_newsletters__newsletter_id__issues__issue_id__send_resume_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/rewrite-text
+   * Rewrite Issue Text
+   * tier: billable · scope: newsletter:run
+   */
+  rewrite_issue_text_newsletters__newsletter_id__issues__issue_id__rewrite_text_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RewriteTextRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/list-syncs/{audience_list_id}/run
+   * Run Newsletter List Sync
+   * tier: write · scope: newsletter:write
+   */
+  run_newsletter_list_sync_newsletters__newsletter_id__list_syncs__audience_list_id__run_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+      /** Audience list id. */
+      audience_list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_Any_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/send
+   * Send Issue
+   * tier: external · scope: newsletter:run
+   */
+  send_issue_newsletters__newsletter_id__issues__issue_id__send_post: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Issue id */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: IssueSendRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/send-test
+   * Send Test Email
+   * tier: external · scope: newsletter:run
+   */
+  send_test_email_newsletters__newsletter_id__issues__issue_id__send_test_post: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Issue id */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: IssueSendTestRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/set-button-action
+   * Set Issue Button Action
+   * tier: write · scope: newsletter:write
+   */
+  set_issue_button_action_newsletters__newsletter_id__issues__issue_id__set_button_action_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetButtonActionRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/set-media-edit
+   * Set Issue Media Edit
+   * tier: write · scope: newsletter:write
+   */
+  set_issue_media_edit_newsletters__newsletter_id__issues__issue_id__set_media_edit_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetMediaEditRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/issues/{issue_id}/set-text
+   * Set Issue Text
+   * tier: write · scope: newsletter:write
+   */
+  set_issue_text_newsletters__newsletter_id__issues__issue_id__set_text_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+      /** Issue id. */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetTextRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/templates/{template_id}/approval
+   * Set Template Approval
+   * tier: write · scope: newsletter:write
+   */
+  set_template_approval_newsletters_templates__template_id__approval_post: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetTemplateApprovalRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/templates/{template_id}/set-button-action
+   * Set Template Button Action
+   * tier: write · scope: newsletter:write
+   */
+  set_template_button_action_newsletters_templates__template_id__set_button_action_post: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetButtonActionRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/templates/{template_id}/set-media-edit
+   * Set Template Media Edit
+   * tier: write · scope: newsletter:write
+   */
+  set_template_media_edit_newsletters_templates__template_id__set_media_edit_post: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetMediaEditRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * GET /newsletters/templates/{template_id}/generation-status
+   * Template Generation Status
+   * tier: read · scope: newsletter:read
+   */
+  template_generation_status_newsletters_templates__template_id__generation_status_get: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * DELETE /newsletters/{newsletter_id}/campaign
+   * Unlink Newsletter Campaign
+   * tier: destructive · scope: newsletter:delete
+   */
+  unlink_newsletter_campaign_newsletters__newsletter_id__campaign_delete: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * PATCH /newsletters/{newsletter_id}/subscribers/{subscriber_id}/unsubscribe
+   * Unsubscribe Subscriber
+   * tier: external · scope: newsletter:run
+   */
+  unsubscribe_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__unsubscribe_patch: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Subscriber id */
+      subscriber_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PUT /newsletters/{newsletter_id}/issues/{issue_id}
+   * Update Issue
+   * tier: external · scope: newsletter:run
+   */
+  update_issue_newsletters__newsletter_id__issues__issue_id__put: {
+    input: {
+    path: {
+      /** Newsletter UUID */
+      newsletter_id: string;
+      /** Issue id */
+      issue_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: IssueUpdateRequest;
+  };
+    output: ApiResponse_IssueDetail_;
+  };
+  /**
+   * PATCH /newsletters/{newsletter_id}
+   * Update Newsletter
+   * tier: write · scope: newsletter:write
+   */
+  update_newsletter_newsletters__newsletter_id__patch: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateNewsletterRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * PUT /newsletters/{newsletter_id}/settings
+   * Update Newsletter Settings
+   * tier: write · scope: newsletter:write
+   */
+  update_newsletter_settings_newsletters__newsletter_id__settings_put: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateNewsletterSettingsRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * PATCH /newsletters/templates/{template_id}
+   * Update Newsletter Template
+   * tier: write · scope: newsletter:write
+   */
+  update_newsletter_template_newsletters_templates__template_id__patch: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: NewsletterTemplateUpdateRequest;
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+  /**
+   * POST /newsletters/templates/{template_id}/use
+   * Use Template
+   * tier: write · scope: newsletter:write
+   */
+  use_template_newsletters_templates__template_id__use_post: {
+    input: {
+    path: {
+      /** Template id. */
+      template_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UseTemplateRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/settings/verify-domain
+   * Verify Newsletter Domain
+   * tier: external · scope: newsletter:run
+   */
+  verify_newsletter_domain_newsletters__newsletter_id__settings_verify_domain_post: {
+    input: {
+    path: {
+      /** Newsletter id (UUID). */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VerifyDomainRequest;
+  };
+    output: ApiResponse_NewsletterPayload_;
+  };
+  /**
+   * POST /newsletters/{newsletter_id}/subscribers/verify
+   * Verify Newsletter Subscribers
+   * tier: billable · scope: newsletter:run
+   */
+  verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post: {
+    input: {
+    path: {
+      /** Newsletter id. */
+      newsletter_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NewsletterStudioPayload_;
+  };
+}
+
+// 50 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_Any_ {
+  data: unknown;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_IssueAnalyticsKpis_ {
+  data: IssueAnalyticsKpis;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_IssueDetail_ {
+  data: IssueDetail;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ListSyncListResponse_ {
+  data: ListSyncListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NewsletterDetail_ {
+  data: NewsletterDetail;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NewsletterListPayload_ {
+  data: NewsletterListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NewsletterPayload_ {
+  data: NewsletterPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NewsletterStatusResponse_ {
+  data: NewsletterStatusResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NewsletterStudioPayload_ {
+  data: NewsletterStudioPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SubscriberListResponse_ {
+  data: SubscriberListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SubscriberSummary_ {
+  data: SubscriberSummary;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_ {
+  data: Array<unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+/** Bulk-import an audience list's contacts as subscribers. */
+export interface ImportAudienceRequest {
+  /** Integer audience id, not a UUID. */
+  audience_id: number;
+}
+
+/**
+ * ``GET /{newsletter_id}/issues/{issue_id}/analytics/kpis``. Open dict
+ * for the ``kpis`` bucket — bucketed counters evolve independently of
+ * this API surface (see ``issue_analytics_router.py`` docstring).
+ */
+export interface IssueAnalyticsKpis {
+  kpis?: Record<string, unknown>;
+  last_updated_at?: string | null;
+  stale?: boolean | null;
+  [key: string]: unknown;
+}
+
+export interface IssueCreateRequest {
+  html_body: string;
+  plain_text?: string | null;
+  preview_text?: string | null;
+  reply_to?: string | null;
+  sender_email?: string | null;
+  sender_name?: string | null;
+  subject: string;
+}
+
+/**
+ * A single newsletter issue. Open dict — the internal handler returns
+ * the row dict plus derived KPI/status fields.
+ */
+export interface IssueDetail {
+  created_at?: string | null;
+  id?: number | null;
+  newsletter_id?: string | null;
+  sent_at?: string | null;
+  status?: string | null;
+  subject?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * Enqueue or schedule an issue for sending. ``scheduled_at`` omitted
+ * (or null) sends immediately.
+ */
+export interface IssueSendRequest {
+  scheduled_at?: string | null;
+}
+
+export interface IssueSendTestRequest {
+  test_email: string;
+}
+
+/**
+ * Partial update for a draft issue. All fields optional — only the
+ * ones sent are changed (mirrors the internal ``exclude_unset=True``
+ * handling in ``update_issue``).
+ */
+export interface IssueUpdateRequest {
+  html_body?: string | null;
+  plain_text?: string | null;
+  preview_text?: string | null;
+  reply_to?: string | null;
+  sender_email?: string | null;
+  sender_name?: string | null;
+  subject?: string | null;
+}
+
+/** One audience list feeding a newsletter's subscribers. */
+export interface ListSync {
+  audience_list_id?: number | null;
+  /** Live count the worker will act on. */
+  contact_count?: number | null;
+  /** False on a SYNTHETIC candidate row - a list resolved by `?audience_list_id=` that has no saved sync yet. */
+  enabled?: boolean | null;
+  /** Live list name. */
+  name?: string | null;
+  [key: string]: unknown;
+}
+
+export interface ListSyncEnableRequest {
+  /** The exact consent wording shown to the operator, stored VERBATIM so the trail survives future copy edits. Send what your UI displayed, not a summary of it. */
+  attested_text?: string | null;
+  /** Audience list to attach. */
+  audience_list_id: number;
+}
+
+/**
+ * Audience lists attached to a newsletter.
+ *
+ * The app returns a bare LIST here, not an object, so `from_internal` accepts
+ * both that and the wrapped shapes rather than 500-ing if it ever changes.
+ */
+export interface ListSyncListResponse {
+  list_syncs?: Array<ListSync>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+export interface NewsletterCampaignLinkRequest {
+  /** The Studio campaign to link. */
+  campaign_id: string;
+}
+
+/** Create a new newsletter. Mirrors ``CreateNewsletterRequest``. */
+export interface NewsletterCreateRequest {
+  goal?: string | null;
+  name: string;
+}
+
+/** A single newsletter row. Open dict — mirrors ``_serialize_newsletter``. */
+export interface NewsletterDetail {
+  audience_list_id?: unknown | null;
+  created_at?: string | null;
+  goal?: string | null;
+  id?: string | null;
+  name?: string | null;
+  slug?: string | null;
+  status?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+}
+
+export interface NewsletterIssueGenerateRequest {
+  /** `email_safe`: table layout, inline CSS. `modern`: div layout. */
+  html_mode?: "email_safe" | "modern";
+  /** What the issue should cover. */
+  prompt?: string | null;
+  /** Base the issue on this template. */
+  template_id?: number | null;
+}
+
+/** An open envelope for a LIST result, so a bare list keeps its shape. */
+export interface NewsletterListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** An open envelope for a newsletter, an issue, a template or a send row. */
+export type NewsletterPayload = Record<string, unknown>;
+
+/** The result of a lifecycle transition. */
+export interface NewsletterStatusResponse {
+  id?: string | null;
+  /** Status after the transition, e.g. `paused`, `completed`. */
+  status?: string | null;
+  [key: string]: unknown;
+}
+
+/** An issue, version list, template, verification job or link result. */
+export type NewsletterStudioPayload = Record<string, unknown>;
+
+export interface NewsletterTemplateUpdateRequest {
+  html_body?: string | null;
+  name?: string | null;
+  preview_text?: string | null;
+  subject?: string | null;
+}
+
+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;
+}
+
+/** Rewrite ONE element with an AI instruction. THIS SPENDS AI CREDIT. */
+export interface RewriteTextRequest {
+  element_id: string;
+  /** What to change, in plain words. */
+  instruction: string;
+}
+
+/** Why the send was stopped. Recorded on the send row. */
+export interface SendControlRequest {
+  reason?: string | null;
+}
+
+/**
+ * Repoint a button.
+ *
+ * `action_type` is CLOSED to `url` and `mailto`. The app narrows the wider
+ * landing-page action union to those two for email, so a third value reaches
+ * a real `Literal` inside the handler and would escape as a 500.
+ */
+export interface SetButtonActionRequest {
+  action_type: "url" | "mailto";
+  /** For `mailto`. */
+  email?: string | null;
+  g8_action_id: string;
+  /** For `url`. */
+  href?: string | null;
+  target?: ("_self" | "_blank") | null;
+}
+
+/**
+ * Change or remove an image.
+ *
+ * Email surfaces handle `<img>` only - no video and no per-breakpoint
+ * positioning - which is why this carries a smaller set of fields than the
+ * landing-page equivalent.
+ */
+export interface SetMediaEditRequest {
+  align?: ("left" | "center" | "right") | null;
+  alt?: string | null;
+  g8_action_id: string;
+  height?: number | null;
+  /** Delete the image. Other fields are then ignored. */
+  remove?: boolean;
+  src?: string | null;
+  width?: number | null;
+}
+
+/**
+ * Move a template through its lifecycle.
+ *
+ * `approved` is what makes it visible in the gallery; `archived` takes it out
+ * without deleting it. Closed to the app's three values.
+ */
+export interface SetTemplateApprovalRequest {
+  status: "draft" | "approved" | "archived";
+}
+
+/** Replace the text of ONE element, exactly as given. */
+export interface SetTextRequest {
+  /** `g8` element id from the rendered HTML. */
+  element_id: string;
+  new_text: string;
+}
+
+export interface SubscriberAddRequest {
+  email: string;
+  first_name?: string | null;
+  last_name?: string | null;
+}
+
+/**
+ * ``GET /{newsletter_id}/subscribers`` — preserves the internal
+ * ``{items, total, page, page_size}`` shape verbatim.
+ */
+export interface SubscriberListResponse {
+  items?: Array<SubscriberSummary>;
+  page?: number;
+  page_size?: number;
+  total?: number;
+}
+
+/** A single newsletter subscriber row. */
+export interface SubscriberSummary {
+  created_at?: string | null;
+  email?: string | null;
+  first_name?: string | null;
+  id?: number | null;
+  last_name?: string | null;
+  status?: string | null;
+  verification_status?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * Import an existing email as a template.
+ *
+ * `source` says which of the three optional inputs is the real one: `url`
+ * reads `url`, `past_issue` reads `issue_id`, `html` reads `html`. It is
+ * deliberately left an open string rather than a `Literal`, because the app
+ * leaves it open - closing it here would 422 a source the app added.
+ */
+export interface TemplateCloneRequest {
+  html?: string | null;
+  issue_id?: string | null;
+  /** Keep the original images rather than dropping them. */
+  keep_images?: boolean;
+  /** Restyle the import to the org's brand. */
+  reskin?: boolean;
+  /** `url`, `past_issue` or `html`. */
+  source: string;
+  url?: string | null;
+}
+
+/** Build a template from a named layout archetype. ASYNC and AI-backed. */
+export interface TemplateFromLayoutRequest {
+  /** Which layout to build from. */
+  archetype_key: string;
+  /** Audience the copy is aimed at. */
+  audience_id?: string | null;
+}
+
+/** Build a template from a plain-language idea. ASYNC and AI-backed. */
+export interface TemplateFromPromptRequest {
+  audience_id?: string | null;
+  /** What it is for, e.g. `product`. */
+  goal?: string;
+  /** What the email should say, in plain words. */
+  idea: string;
+  length?: string | null;
+  tone?: string | null;
+  /** How many alternatives to generate. */
+  variants?: number | null;
+  /** Past issues to imitate the voice of. */
+  voice_reference_issue_ids?: Array<string>;
+}
+
+/**
+ * Poll many template builds in one call.
+ *
+ * Capped at 200 ids, matching the app. The cap is not arbitrary: a dashboard
+ * polls this every two seconds and an unbounded `IN (...)` is a denial-of-
+ * service surface, which is why it is enforced here as a 422 rather than
+ * reached inside the handler.
+ */
+export interface TemplateGenerationStatusBatchRequest {
+  template_ids: Array<number>;
+}
+
+/** Rename a newsletter, restate its goal, or point it at a different list. */
+export interface UpdateNewsletterRequest {
+  /** The audience new subscribers are drawn from. Changing it does NOT move anybody who is already subscribed. */
+  audience_list_id?: string | null;
+  /** What the newsletter is for. Steers AI drafting. */
+  goal?: string | null;
+  name?: string | null;
+}
+
+/** Who a newsletter sends as, and how strict its opt-in is. */
+export interface UpdateNewsletterSettingsRequest {
+  auto_verify_on_import?: boolean | null;
+  default_reply_to?: string | null;
+  default_sender_email?: string | null;
+  default_sender_name?: string | null;
+  /** The ACTIVE double-opt-in flag the send pipeline reads. Legacy: a `true` written here is routed to `double_opt_in_intent` and the active flag is auto-promoted once the domain and sender are ready. */
+  double_opt_in?: boolean | null;
+  /** The REQUEST for double opt-in, independent of readiness. Set this rather than `double_opt_in` - it is promoted automatically. */
+  double_opt_in_intent?: boolean | null;
+  /** Must be verified first - see `settings/verify-domain`. */
+  sending_domain?: string | null;
+  skip_unverified_subscribers?: boolean | null;
+}
+
+/** Turn a template into a new draft issue on a newsletter. */
+export interface UseTemplateRequest {
+  /** Which newsletter the draft issue is created on. */
+  newsletter_id: string;
+}
+
+/** Start verification of a sending domain. */
+export interface VerifyDomainRequest {
+  /** Sending subdomain, e.g. `updates.acme.com`. */
+  domain: string;
+}