@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/gtmContext.d.ts

@@ -0,0 +1,1187 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.gtmContext` (GTM Context): 51 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"approve_company_profile_company_profile_approve_post">;
+ *
+ * Reference with examples: gtmContext.md
+ */
+/* eslint-disable */
+
+/** `g8.api.gtmContext.<member>` -> the operationId it calls. */
+export interface GtmContextMembers {
+  approveCompanyProfile: "approve_company_profile_company_profile_approve_post";
+  approveCompanyProfileKeywords: "approve_company_profile_keywords_company_profile_keywords_approve_post";
+  archiveIcp: "archive_icp_icps__icp_id__archive_post";
+  archivePersona: "archive_persona_personas__persona_id__archive_post";
+  createIcp: "create_icp_icps_post";
+  createPersona: "create_persona_personas_post";
+  deleteAllDocuments: "delete_all_documents_global_context_documents_delete";
+  deleteDocument: "delete_document_global_context_documents__doc_type__delete";
+  extractCompanyData: "extract_company_data_global_context_extract_company_data_post";
+  generateAllDocuments: "generate_all_documents_global_context_generate_all_post";
+  generateCompanyProfile: "generate_company_profile_company_profile_generate_post";
+  getBuyingJourneyCrmStatus: "get_buying_journey_crm_status_global_context_documents_buying_journey_crm_status_get";
+  getCompanyProfile: "get_company_profile_company_profile_get";
+  getCompanyProfileWorkflowStatus: "get_company_profile_workflow_status_company_profile_workflow_status_get";
+  getDocHighlights: "get_doc_highlights_global_context_doc__doc_type__highlights_get";
+  getDocumentsAnalytics: "get_documents_analytics_global_context_documents_analytics_get";
+  getGlobalContextDocument: "get_global_context_document_global_context_documents__doc_id__get";
+  getLatestPipeline: "get_latest_pipeline_global_context_pipeline_latest_get";
+  getMailboxWarmupAnalytics: "get_mailbox_warmup_analytics_mailboxes__mailbox_id__warmup_get";
+  getPipelineStatus: "get_pipeline_status_global_context_pipeline__pipeline_id__get";
+  listActivities: "list_activities_activities_get";
+  listGlobalContextDocuments: "list_global_context_documents_global_context_documents_get";
+  listIcps: "list_icps_icps_get";
+  listIntelligenceData: "list_intelligence_data_intelligence_data_get";
+  listMailboxes: "list_mailboxes_mailboxes_get";
+  listPersonas: "list_personas_personas_get";
+  listPipelines: "list_pipelines_global_context_pipelines_get";
+  listResearchReports: "list_research_reports_research_reports_get";
+  regenerateGlobalContext: "regenerate_global_context_global_context_regenerate_post";
+  regenerateOneDocument: "regenerate_one_document_global_context__doc_id__regenerate_post";
+  reindexAllDocuments: "reindex_all_documents_global_context_reindex_all_post";
+  reindexCompanyProfile: "reindex_company_profile_company_profile_reindex_post";
+  resetCompanyProfileKeywords: "reset_company_profile_keywords_company_profile_keywords_delete";
+  resetStuckDocuments: "reset_stuck_documents_global_context_reset_stuck_documents_post";
+  resumePipeline: "resume_pipeline_global_context_resume_pipeline_post";
+  retryCompanyProfile: "retry_company_profile_company_profile_retry_post";
+  saveBuyingJourneyInterview: "save_buying_journey_interview_global_context_documents_buying_journey_interview_post";
+  scaffoldAllDocuments: "scaffold_all_documents_global_context_scaffold_post";
+  scaffoldCompanyKeywords: "scaffold_company_keywords_global_context_scaffold_company_keywords_post";
+  scaffoldCompanyProfile: "scaffold_company_profile_global_context_scaffold_company_profile_post";
+  stopAllGeneration: "stop_all_generation_global_context_stop_all_generation_post";
+  submitDocumentFeedback: "submit_document_feedback_global_context_documents__doc_id__feedback_post";
+  trackDocumentUsage: "track_document_usage_global_context_documents__doc_id__track_usage_post";
+  unapproveCompanyProfile: "unapprove_company_profile_company_profile_unapprove_post";
+  updateCompanyProfile: "update_company_profile_company_profile_put";
+  updateGlobalContextDocument: "update_global_context_document_global_context_documents__doc_id__patch";
+  updateIcp: "update_icp_icps__icp_id__patch";
+  updatePersona: "update_persona_personas__persona_id__patch";
+  updateResearchReport: "update_research_report_research_reports__report_id__patch";
+  uploadCompanyProfileLogo: "upload_company_profile_logo_company_profile_logo_post";
+  uploadEnablementAsset: "upload_enablement_asset_enablement_assets_post";
+}
+
+/** Input and output of every `g8.api.gtmContext` operation, keyed by operationId. */
+export interface GtmContextOperations {
+  /**
+   * POST /company-profile/approve
+   * Approve Company Profile
+   * tier: write · scope: campaigns:write
+   */
+  approve_company_profile_company_profile_approve_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileWebsiteRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /company-profile/keywords/approve
+   * Approve Company Profile Keywords
+   * tier: write · scope: campaigns:write
+   */
+  approve_company_profile_keywords_company_profile_keywords_approve_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileWebsiteRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /icps/{icp_id}/archive
+   * Archive Icp
+   * tier: destructive · scope: campaigns:delete
+   */
+  archive_icp_icps__icp_id__archive_post: {
+    input: {
+    path: {
+      /** ICP ID (UUID) */
+      icp_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /personas/{persona_id}/archive
+   * Archive Persona
+   * tier: destructive · scope: campaigns:delete
+   */
+  archive_persona_personas__persona_id__archive_post: {
+    input: {
+    path: {
+      /** Persona ID (UUID) */
+      persona_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /icps
+   * Create Icp
+   * tier: write · scope: campaigns:write
+   */
+  create_icp_icps_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateIcpRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /personas
+   * Create Persona
+   * tier: write · scope: campaigns:write
+   */
+  create_persona_personas_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreatePersonaRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * DELETE /global-context/documents
+   * Delete All Documents
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_all_documents_global_context_documents_delete: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * DELETE /global-context/documents/{doc_type}
+   * Delete Document
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_document_global_context_documents__doc_type__delete: {
+    input: {
+    path: {
+      /** Document type key, e.g. `company_profile`, `icp_research`, `buying_journey`. Free-form on purpose: the set grows with the product and a closed list here would 422 a document the org already has. */
+      doc_type: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/extract-company-data
+   * Extract Company Data
+   * tier: write · scope: campaigns:write
+   */
+  extract_company_data_global_context_extract_company_data_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ExtractCompanyDataRequest;
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/generate-all
+   * Generate All Documents
+   * tier: billable · scope: campaigns:run
+   */
+  generate_all_documents_global_context_generate_all_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: GenerateAllDocumentsRequest;
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /company-profile/generate
+   * Generate Company Profile
+   * tier: billable · scope: campaigns:run
+   */
+  generate_company_profile_company_profile_generate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileFieldsRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * GET /global-context/documents/buying-journey/crm-status
+   * Get Buying Journey Crm Status
+   * tier: read · scope: campaigns:read
+   */
+  get_buying_journey_crm_status_global_context_documents_buying_journey_crm_status_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * GET /company-profile
+   * Get Company Profile
+   * tier: read · scope: campaigns:read
+   */
+  get_company_profile_company_profile_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /company-profile/workflow-status
+   * Get Company Profile Workflow Status
+   * tier: read · scope: campaigns:read
+   */
+  get_company_profile_workflow_status_company_profile_workflow_status_get: {
+    input: {
+    query: {
+      /** The website the profile was built from. */
+      website_url: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * GET /global-context/doc/{doc_type}/highlights
+   * Get Doc Highlights
+   * tier: read · scope: campaigns:read
+   */
+  get_doc_highlights_global_context_doc__doc_type__highlights_get: {
+    input: {
+    path: {
+      /** Document type key, e.g. `company_profile`, `icp_research`, `buying_journey`. Free-form on purpose: the set grows with the product and a closed list here would 422 a document the org already has. */
+      doc_type: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * GET /global-context/documents/analytics
+   * Get Documents Analytics
+   * tier: read · scope: campaigns:read
+   */
+  get_documents_analytics_global_context_documents_analytics_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioListPayload_;
+  };
+  /**
+   * GET /global-context/documents/{doc_id}
+   * Get Global Context Document
+   * tier: read · scope: campaigns:read
+   */
+  get_global_context_document_global_context_documents__doc_id__get: {
+    input: {
+    path: {
+      /** Document id, OR a document TYPE key. The app resolves either, which is what makes `company_profile` a usable id. */
+      doc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * GET /global-context/pipeline/latest
+   * Get Latest Pipeline
+   * tier: read · scope: campaigns:read
+   */
+  get_latest_pipeline_global_context_pipeline_latest_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * GET /mailboxes/{mailbox_id}/warmup
+   * Get Mailbox Warmup Analytics
+   * tier: read · scope: campaigns:read
+   */
+  get_mailbox_warmup_analytics_mailboxes__mailbox_id__warmup_get: {
+    input: {
+    path: {
+      mailbox_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /global-context/pipeline/{pipeline_id}
+   * Get Pipeline Status
+   * tier: read · scope: campaigns:read
+   */
+  get_pipeline_status_global_context_pipeline__pipeline_id__get: {
+    input: {
+    path: {
+      /** Pipeline id. */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * GET /activities
+   * List Activities
+   * tier: read · scope: campaigns:read
+   */
+  list_activities_activities_get: {
+    input: {
+    query?: {
+      page?: number;
+      limit?: number;
+      activity_type?: string | null;
+      contact_id?: string | null;
+      company_id?: string | null;
+      mashup_contact_id?: number | null;
+      mashup_company_id?: number | null;
+      deal_id?: string | null;
+      occurred_after?: string | null;
+      occurred_before?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /global-context/documents
+   * List Global Context Documents
+   * tier: read · scope: campaigns:read
+   */
+  list_global_context_documents_global_context_documents_get: {
+    input: {
+    query?: {
+      /** Filter by context category */
+      category?: string | null;
+      /** Include each document's body text at `content` (read from meta_data.content). Default True preserves historical behavior (this endpoint has always returned content); pass false for a lighter metadata-only listing. */
+      include_content?: boolean;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /icps
+   * List Icps
+   * tier: read · scope: campaigns:read
+   */
+  list_icps_icps_get: {
+    input: {
+    query?: {
+      /** Filter by ICP status */
+      status?: string | null;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /intelligence-data
+   * List Intelligence Data
+   * tier: read · scope: campaigns:read
+   */
+  list_intelligence_data_intelligence_data_get: {
+    input: {
+    query?: {
+      /** Filter by data_type (website_scrape, company_enrichment, competitor_discovery, company_keywords, product_inventory, organic_keywords, paid_keywords, ...) */
+      data_type?: string | null;
+      /** Include the raw `data` JSONB blob (large; default omits) */
+      include_content?: boolean;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /mailboxes
+   * List Mailboxes
+   * tier: read · scope: campaigns:read
+   */
+  list_mailboxes_mailboxes_get: {
+    input: {
+    query?: {
+      limit?: number;
+      /** Include archived mailboxes */
+      include_archived?: boolean;
+      /** Filter by connection_status (active|paused|disconnected|expired|...) */
+      connection_status?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /personas
+   * List Personas
+   * tier: read · scope: campaigns:read
+   */
+  list_personas_personas_get: {
+    input: {
+    query?: {
+      /** Filter by persona status */
+      status?: string | null;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * GET /global-context/pipelines
+   * List Pipelines
+   * tier: read · scope: campaigns:read
+   */
+  list_pipelines_global_context_pipelines_get: {
+    input: {
+    query?: {
+      /** How many recent runs to return. The app's default is 10. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioListPayload_;
+  };
+  /**
+   * GET /research-reports
+   * List Research Reports
+   * tier: read · scope: campaigns:read
+   */
+  list_research_reports_research_reports_get: {
+    input: {
+    query?: {
+      /** Filter by report_type (buyer_psychology, competitive_teardown, gtm_channel, industry_analyst, review_sentiment, voice_of_customer) */
+      report_type?: string | null;
+      /** Include the structured `content` JSONB blob + markdown (large) */
+      include_content?: boolean;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_dict__;
+  };
+  /**
+   * POST /global-context/regenerate
+   * Regenerate Global Context
+   * tier: write · scope: campaigns:write
+   */
+  regenerate_global_context_global_context_regenerate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RegenerateContextRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /global-context/{doc_id}/regenerate
+   * Regenerate One Document
+   * tier: write · scope: campaigns:write
+   */
+  regenerate_one_document_global_context__doc_id__regenerate_post: {
+    input: {
+    path: {
+      /** Document id. */
+      doc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/reindex-all
+   * Reindex All Documents
+   * tier: write · scope: campaigns:write
+   */
+  reindex_all_documents_global_context_reindex_all_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /company-profile/reindex
+   * Reindex Company Profile
+   * tier: billable · scope: campaigns:run
+   */
+  reindex_company_profile_company_profile_reindex_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileWebsiteRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * DELETE /company-profile/keywords
+   * Reset Company Profile Keywords
+   * tier: destructive · scope: campaigns:delete
+   */
+  reset_company_profile_keywords_company_profile_keywords_delete: {
+    input: {
+    query: {
+      /** The website the profile was built from. */
+      website_url: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /global-context/reset-stuck-documents
+   * Reset Stuck Documents
+   * tier: destructive · scope: campaigns:delete
+   */
+  reset_stuck_documents_global_context_reset_stuck_documents_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/resume-pipeline
+   * Resume Pipeline
+   * tier: write · scope: campaigns:write
+   */
+  resume_pipeline_global_context_resume_pipeline_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /company-profile/retry
+   * Retry Company Profile
+   * tier: billable · scope: campaigns:run
+   */
+  retry_company_profile_company_profile_retry_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileWebsiteRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /global-context/documents/buying-journey/interview
+   * Save Buying Journey Interview
+   * tier: write · scope: campaigns:write
+   */
+  save_buying_journey_interview_global_context_documents_buying_journey_interview_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BuyingJourneyInterviewRequest;
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/scaffold
+   * Scaffold All Documents
+   * tier: write · scope: campaigns:write
+   */
+  scaffold_all_documents_global_context_scaffold_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/scaffold-company-keywords
+   * Scaffold Company Keywords
+   * tier: write · scope: campaigns:write
+   */
+  scaffold_company_keywords_global_context_scaffold_company_keywords_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/scaffold-company-profile
+   * Scaffold Company Profile
+   * tier: write · scope: campaigns:write
+   */
+  scaffold_company_profile_global_context_scaffold_company_profile_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/stop-all-generation
+   * Stop All Generation
+   * tier: write · scope: campaigns:write
+   */
+  stop_all_generation_global_context_stop_all_generation_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/documents/{doc_id}/feedback
+   * Submit Document Feedback
+   * tier: write · scope: campaigns:write
+   */
+  submit_document_feedback_global_context_documents__doc_id__feedback_post: {
+    input: {
+    path: {
+      /** Document id. */
+      doc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DocumentFeedbackRequest;
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /global-context/documents/{doc_id}/track-usage
+   * Track Document Usage
+   * tier: write · scope: campaigns:write
+   */
+  track_document_usage_global_context_documents__doc_id__track_usage_post: {
+    input: {
+    path: {
+      /** Global Context document ID. */
+      doc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TrackDocumentUsageRequest;
+  };
+    output: ApiResponse_StudioPayload_;
+  };
+  /**
+   * POST /company-profile/unapprove
+   * Unapprove Company Profile
+   * tier: write · scope: campaigns:write
+   */
+  unapprove_company_profile_company_profile_unapprove_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ProfileWebsiteRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * PUT /company-profile
+   * Update Company Profile
+   * tier: write · scope: campaigns:write
+   */
+  update_company_profile_company_profile_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CompanyProfileUpdateRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PATCH /global-context/documents/{doc_id}
+   * Update Global Context Document
+   * tier: write · scope: campaigns:write
+   */
+  update_global_context_document_global_context_documents__doc_id__patch: {
+    input: {
+    path: {
+      /** Global context document ID (UUID) */
+      doc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateGlobalContextRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PATCH /icps/{icp_id}
+   * Update Icp
+   * tier: write · scope: campaigns:write
+   */
+  update_icp_icps__icp_id__patch: {
+    input: {
+    path: {
+      /** ICP ID (UUID) */
+      icp_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateIcpRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PATCH /personas/{persona_id}
+   * Update Persona
+   * tier: write · scope: campaigns:write
+   */
+  update_persona_personas__persona_id__patch: {
+    input: {
+    path: {
+      /** Persona ID (UUID) */
+      persona_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdatePersonaRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * PATCH /research-reports/{report_id}
+   * Update Research Report
+   * tier: billable · scope: campaigns:run
+   */
+  update_research_report_research_reports__report_id__patch: {
+    input: {
+    path: {
+      /** Research report ID (UUID) */
+      report_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateResearchReportRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /company-profile/logo
+   * Upload Company Profile Logo
+   * tier: write · scope: campaigns:write
+   */
+  upload_company_profile_logo_company_profile_logo_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /enablement/assets
+   * Upload Enablement Asset
+   * tier: write · scope: campaigns:write
+   */
+  upload_enablement_asset_enablement_assets_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EnablementAssetUploadRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+}
+
+// 25 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_CrmRecordPayload_ {
+  data: CrmRecordPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioListPayload_ {
+  data: StudioListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioPayload_ {
+  data: StudioPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_dict__ {
+  data: Array<Record<string, unknown>>;
+  pagination?: PaginationMeta | null;
+}
+
+/**
+ * The typed form of the untyped `dict` body the interview route takes.
+ *
+ * The app reads `answers` and 400s when it is empty. Typed so that is a 422,
+ * and so the shape is discoverable.
+ */
+export interface BuyingJourneyInterviewRequest {
+  /** Structured interview answers about how this organisation sells. Injected as highest-priority grounding the next time the buying journey document is generated. */
+  answers: Record<string, unknown>;
+}
+
+export interface CompanyProfileUpdateRequest {
+  /** Profile fields to save, e.g. {'company_name': 'Acme', 'industry': 'Manufacturing'}. Replaces the stored field set. */
+  fields: Record<string, string>;
+  /** Approved profiles are immutable by design. Set true to explicitly unlock and overwrite a human-approved profile. Left false, an approved profile returns 409 instead of being silently unapproved. */
+  unapprove_if_approved?: boolean;
+  /** The client's real website. This is the source of truth Studio generation reads; setting it wrong is what makes every downstream ICP, persona and campaign describe the wrong company. */
+  website_url: string;
+}
+
+/**
+ * Body for POST /icps - create a Studio ICP manually (no AI generation).
+ *
+ * Mirrors the internal Studio "Add ICP" action. Manual ICPs are created with
+ * status 'active'; the fit/opportunity/readiness/total scores stay null (they are
+ * only produced by the AI generate flow, which this endpoint does not run).
+ */
+export interface CreateIcpRequest {
+  /** List of buying-intent signals. */
+  buying_signals?: Array<unknown> | null;
+  /** Freeform ICP description. */
+  description?: string | null;
+  /** Estimated addressable-market count. */
+  estimated_market_size?: number | null;
+  /** Firmographic criteria (industry, size, geo, ...). */
+  firmographics?: Record<string, unknown> | null;
+  /** ICP name/title. */
+  name: string;
+  /** Technology signals. */
+  tech_stack?: Record<string, unknown> | null;
+  /** The org website this ICP belongs to. */
+  website_url: string;
+}
+
+/**
+ * Body for POST /personas - create a Studio buyer persona manually.
+ *
+ * Mirrors the internal Studio "Add Persona" action. Manual personas are created
+ * with status 'active'; AI/score fields stay null (they are only populated by the
+ * AI generate flow, which this endpoint intentionally does not run).
+ */
+export interface CreatePersonaRequest {
+  /** Recommended campaign approach. */
+  campaign_approach?: string | null;
+  /** Confidence label (e.g. 'high'/'medium'/'low'). Defaults to 'medium'. */
+  confidence?: string | null;
+  /** Expected receptivity note. */
+  expected_receptivity?: string | null;
+  /** List of buying/intent signals. */
+  key_signals?: Array<unknown> | null;
+  /** Display priority (lower sorts first). Defaults to 1. */
+  priority?: number | null;
+  /** Recommended campaign goal. */
+  recommended_goal?: string | null;
+  /** Origin label for the persona. Defaults to 'manual'. */
+  source?: string | null;
+  /** Persona title (e.g. 'Director of Marketing Operations'). */
+  title: string;
+  /** The org website this persona belongs to. */
+  website_url: string;
+  /** Why this persona is worth targeting. */
+  why_target?: string | null;
+}
+
+/**
+ * An open envelope for one record, one dashboard or one job receipt.
+ *
+ * Open because most of these reads are COMPUTED shapes - an engagement
+ * summary, a next-best-step, an intelligence status - that grow with the
+ * product, and dropping a field from an advisory read makes it say "nothing
+ * to report" rather than "we did not tell you".
+ */
+export type CrmRecordPayload = Record<string, unknown>;
+
+/**
+ * Mirrors `campaign_builder.routers.global_context.FeedbackRequest`.
+ *
+ * `feedback_type` is a Literal where the app takes `str` and rejects anything
+ * but `up`/`down` from inside the handler.
+ */
+export interface DocumentFeedbackRequest {
+  /** Thumbs up or thumbs down on the document. */
+  feedback_type: "up" | "down";
+  /** The usage record this feedback is about, when the feedback follows a specific use of the document rather than the document itself. */
+  usage_id?: string | null;
+}
+
+/** Base64 file upload for the org's Studio Enablement library. */
+export interface EnablementAssetUploadRequest {
+  content_base64: string;
+  file_name: string;
+  folder?: string | null;
+  mime_type?: string | null;
+  tags?: Array<string>;
+}
+
+/**
+ * The typed form of the untyped `dict` body `extract-company-data` takes.
+ *
+ * The app reads exactly two keys off that dict and 400s when `website_url` is
+ * missing. Typed here so the same mistake is a parse-layer 422 naming the
+ * field, and so the caller can see that `enrich` exists at all - it is
+ * invisible in an untyped body.
+ *
+ * NOT a mirrored model: there is no app model to mirror. The proxy sends a
+ * plain dict, exactly as the browser does.
+ */
+export interface ExtractCompanyDataRequest {
+  /** Enrich the extracted fields through Apollo. SPENDS CREDITS - the call is credit-gated and answers 402 when the balance is short. */
+  enrich?: boolean;
+  /** Company website to extract from. Intelligence data for it must already exist. */
+  website_url: string;
+}
+
+/**
+ * Mirrors `campaign_builder.routers.global_context.GenerateAllDocumentsRequest`.
+ *
+ * ONE-SHOT. The app refuses this with a 409 once a pipeline has completed for
+ * the org, which is why `POST /global-context/regenerate` exists - use that
+ * to rebuild documents that already exist.
+ */
+export interface GenerateAllDocumentsRequest {
+  /** The company website every document is generated against. Intelligence data must already exist for it. */
+  website_url: string;
+}
+
+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;
+}
+
+/** Mirrors `company_profile.SaveProfileRequest`. */
+export interface ProfileFieldsRequest {
+  /** Which profile fields to generate, and their seeds. */
+  fields: Record<string, unknown>;
+  /** The org's website - the profile's key. */
+  website_url: string;
+}
+
+/**
+ * Names the company profile to act on, by the website it was built from.
+ *
+ * Mirrors `campaign_builder.routers.company_profile.ApproveProfileRequest`,
+ * which is the same single field. The reindex route reads the same value as
+ * a QUERY parameter on a POST in the app; it is a body here because a POST
+ * that carries its only input in the URL is the kind of asymmetry a client
+ * library gets wrong once and then works around forever.
+ */
+export interface ProfileWebsiteRequest {
+  /** Website the profile was built from. Matched on its canonical domain. */
+  website_url: string;
+}
+
+export interface RegenerateContextRequest {
+  /** Specific Studio doc types to regenerate (e.g. ['icp_research','persona_research']). Omit to regenerate every document that already exists in the org. */
+  doc_types?: Array<string> | null;
+  /** Website to generate from. After a company-profile change this must be the NEW domain — intelligence is keyed by URL, so passing the old one silently regenerates the same stale content. */
+  website_url: string;
+}
+
+/**
+ * An open envelope for a LIST result, so a bare list keeps its shape.
+ *
+ * A handler that returns `[...]` and one that returns `{"documents": [...]}`
+ * both land on `items`, and the named key is preserved beside it so a caller
+ * reading the app's own spelling is not broken by the normalisation.
+ */
+export interface StudioListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for one settings block, document or brand artefact.
+ *
+ * OPEN on purpose. These surfaces are configuration and generated content,
+ * and both grow: a new toggle on a settings block or a new field on a
+ * generated document must reach a caller on the day it ships, not on the day
+ * somebody remembers to widen a mirror. A closed response model here would
+ * silently DROP the new key, which reads to the caller as "the product does
+ * not have that setting".
+ *
+ * The request side is the opposite and is mirrored exactly - see the module
+ * docstring for why the asymmetry is deliberate.
+ */
+export type StudioPayload = Record<string, unknown>;
+
+/** Mirrors the app handler's query parameters field for field. */
+export interface TrackDocumentUsageRequest {
+  /** ID of the entity that used the document, if any. */
+  source_id?: string | null;
+  /** Where the use happened, e.g. `campaign`, `account`, `copilot`, `research`. Free-form. */
+  source_type?: string | null;
+  /** `creation`: the document was used to generate new content. `citation`: the document was quoted or referenced. */
+  usage_type: "creation" | "citation";
+}
+
+/**
+ * Body for PATCH /global-context/documents/{doc_id}.
+ *
+ * Partial update: send only the fields you want to change. At least one of
+ * ``content`` / ``status`` must be present.
+ */
+export interface UpdateGlobalContextRequest {
+  /** New document body. Stored at meta_data.content. Omit to leave unchanged. */
+  content?: string | null;
+  /** New document status (e.g. 'completed', 'draft'). Omit to leave unchanged. */
+  status?: string | null;
+}
+
+/**
+ * Body for PATCH /icps/{icp_id}. Partial - send only the fields to change.
+ *
+ * At least one field must be present. Archiving is a separate lifecycle action
+ * (POST /icps/{icp_id}/archive), matching the internal Studio split.
+ */
+export interface UpdateIcpRequest {
+  /** New list of buying-intent signals. */
+  buying_signals?: Array<unknown> | null;
+  /** New description. */
+  description?: string | null;
+  /** New estimated market-size count. */
+  estimated_market_size?: number | null;
+  /** New firmographic criteria. */
+  firmographics?: Record<string, unknown> | null;
+  /** New ICP name. */
+  name?: string | null;
+  /** New technology signals. */
+  tech_stack?: Record<string, unknown> | null;
+}
+
+/**
+ * Body for PATCH /personas/{persona_id}. Partial - send only fields to change.
+ *
+ * At least one field must be present. Passing status='archived' is equivalent to
+ * calling POST /personas/{persona_id}/archive.
+ */
+export interface UpdatePersonaRequest {
+  /** New campaign approach. */
+  campaign_approach?: string | null;
+  /** New confidence label. */
+  confidence?: string | null;
+  /** New expected-receptivity note. */
+  expected_receptivity?: string | null;
+  /** New list of buying/intent signals. */
+  key_signals?: Array<unknown> | null;
+  /** New display priority. */
+  priority?: number | null;
+  /** New recommended goal. */
+  recommended_goal?: string | null;
+  /** New status (e.g. 'active', 'archived'). */
+  status?: string | null;
+  /** New persona title. */
+  title?: string | null;
+  /** New 'why target' text. */
+  why_target?: string | null;
+}
+
+/**
+ * Body for PATCH /research-reports/{report_id}.
+ *
+ * Partial update: send only what you want to change. At least one of
+ * ``markdown_content`` / ``status`` must be present.
+ */
+export interface UpdateResearchReportRequest {
+  /** New rendered markdown body. Omit to leave unchanged. Triggers RAG re-index. */
+  markdown_content?: string | null;
+  /** New report status. A report already 'completed'/'approved' can only move between those two states (done reports stay done). */
+  status?: string | null;
+}