@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/enrichment.d.ts

@@ -0,0 +1,3207 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.enrichment` (Enrichment): 114 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"assign_enrichment_configuration_enrichment_configs__config_id__assignments_post">;
+ *
+ * Reference with examples: enrichment.md
+ */
+/* eslint-disable */
+
+/** `g8.api.enrichment.<member>` -> the operationId it calls. */
+export interface EnrichmentMembers {
+  assignEnrichmentConfiguration: "assign_enrichment_configuration_enrichment_configs__config_id__assignments_post";
+  cancelEnrichmentJob: "cancel_enrichment_job_enrichment_jobs__job_id__cancel_post";
+  cancelListPipelineRun: "cancel_list_pipeline_run_enrichment_lists__list_id__pipelines__pipeline_id__cancel_post";
+  configureFindPeople: "configure_find_people_enrichment_find_people_configure_post";
+  createAutoEnrichmentConfig: "create_auto_enrichment_config_enrichment_auto_enrichment_configs_post";
+  createDefaultWaterfallConfig: "create_default_waterfall_config_enrichment_waterfall_configs_post";
+  createDynamicColumn: "create_dynamic_column_enrichment_columns_post";
+  createEnrichmentConfiguration: "create_enrichment_configuration_enrichment_configs_post";
+  createFormulaConfig: "create_formula_config_enrichment_formula_configs__column_id__post";
+  createFormulaTemplate: "create_formula_template_enrichment_formula_templates_post";
+  createListPipeline: "create_list_pipeline_enrichment_lists__list_id__pipelines_post";
+  createListPipelineFromTemplate: "create_list_pipeline_from_template_enrichment_lists__list_id__pipelines_from_template_post";
+  createRoutingRule: "create_routing_rule_enrichment_list_routing_rules_post";
+  deleteAiConfigByColumn: "delete_ai_config_by_column_enrichment_ai_configs__group_id__columns__column_id__delete";
+  deleteAiConfigByGroup: "delete_ai_config_by_group_enrichment_ai_configs__group_id__delete";
+  deleteAutoEnrichmentConfig: "delete_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__delete";
+  deleteEnrichmentConfig: "delete_enrichment_config_enrichment_configs__config_id__delete";
+  deleteFindPeopleConfig: "delete_find_people_config_enrichment_find_people__config_id__delete";
+  deleteFormulaConfig: "delete_formula_config_enrichment_formula_configs__column_id__delete";
+  deleteListPipeline: "delete_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__delete";
+  deleteRoutingRule: "delete_routing_rule_enrichment_list_routing_rules__rule_id__delete";
+  deleteWaterfallConfig: "delete_waterfall_config_enrichment_waterfall_configs__column_id__delete";
+  draftPipelineWithAi: "draft_pipeline_with_ai_enrichment_lists__list_id__pipelines_ai_draft_post";
+  estimateAllQualificationTemplates: "estimate_all_qualification_templates_enrichment_ai_qualification_estimate_all_post";
+  estimateListPipeline: "estimate_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__estimate_post";
+  estimateQualification: "estimate_qualification_enrichment_ai_qualification_estimate_post";
+  executeRoutingRule: "execute_routing_rule_enrichment_list_routing_rules__rule_id__execute_post";
+  generateAiRunCondition: "generate_ai_run_condition_enrichment_ai_formula_generate_condition_post";
+  generateEnrichmentPrompt: "generate_enrichment_prompt_enrichment_generate_prompt_post";
+  generateFormulaWithAi: "generate_formula_with_ai_enrichment_ai_formula_generate_post";
+  generateQualificationTemplates: "generate_qualification_templates_enrichment_ai_qualification_generate_templates_post";
+  generateRoutingFilter: "generate_routing_filter_enrichment_list_routing_generate_filter_post";
+  getAiBatchJobStatus: "get_ai_batch_job_status_enrichment_ai_batch_jobs__job_id__status_get";
+  getAiConfiguration: "get_ai_configuration_enrichment_ai_configs__group_id__get";
+  getAutoEnrichmentConfig: "get_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__get";
+  getAutoEnrichmentSettings: "get_auto_enrichment_settings_enrichment_auto_enrichment_settings_get";
+  getCompanyGtmProfile: "get_company_gtm_profile_enrichment_companies_gtm_profile_get";
+  getEnrichmentConfiguration: "get_enrichment_configuration_enrichment_configs__config_id__get";
+  getEnrichmentDailyActivity: "get_enrichment_daily_activity_enrichment_analytics_daily_activity_get";
+  getEnrichmentFieldDistribution: "get_enrichment_field_distribution_enrichment_analytics_field_distribution_get";
+  getEnrichmentJob: "get_enrichment_job_enrichment_jobs__job_id__get";
+  getEnrichmentMetrics: "get_enrichment_metrics_enrichment_analytics_metrics_get";
+  getEnrichmentRecordsProgress: "get_enrichment_records_progress_enrichment_records_progress_post";
+  getEnrichmentTrends: "get_enrichment_trends_enrichment_analytics_trends_get";
+  getFindPeopleConfig: "get_find_people_config_enrichment_find_people__config_id__get";
+  getFindPeopleResults: "get_find_people_results_enrichment_find_people__config_id__results__company_id__get";
+  getFormulaConfiguration: "get_formula_configuration_enrichment_formula_configs__column_id__get";
+  getPipelineRun: "get_pipeline_run_enrichment_lists_pipeline_runs__run_id__get";
+  getQualificationFitLandscape: "get_qualification_fit_landscape_enrichment_ai_qualification_fit_landscape_get";
+  getRecordSyncStatus: "get_record_sync_status_enrichment_record_sync__entity_type__status_get";
+  getRoutingRule: "get_routing_rule_enrichment_list_routing_rules__rule_id__get";
+  getWaterfallConfiguration: "get_waterfall_configuration_enrichment_waterfall_configs__column_id__get";
+  getWaterfallJobProgress: "get_waterfall_job_progress_enrichment_waterfall_jobs__job_id__progress_get";
+  importFindPeopleResults: "import_find_people_results_enrichment_find_people__config_id__import_post";
+  listActiveEnrichmentJobs: "list_active_enrichment_jobs_enrichment_active_jobs_get";
+  listAiConfigs: "list_ai_configs_enrichment_ai_configs_get";
+  listAiFormulaAvailableFields: "list_ai_formula_available_fields_enrichment_ai_formula_available_fields_get";
+  listAiTemplates: "list_ai_templates_enrichment_ai_templates_get";
+  listAutoEnrichmentConfigs: "list_auto_enrichment_configs_enrichment_auto_enrichment_configs_get";
+  listConfigAssignments: "list_config_assignments_enrichment_configs__config_id__assignments_get";
+  listEnrichmentConfigurations: "list_enrichment_configurations_enrichment_configs_get";
+  listEnrichmentProviders: "list_enrichment_providers_enrichment_providers_get";
+  listFormulaTemplates: "list_formula_templates_enrichment_formula_templates_get";
+  listListPipelineRuns: "list_list_pipeline_runs_enrichment_lists__list_id__pipelines__pipeline_id__runs_get";
+  listListPipelines: "list_list_pipelines_enrichment_lists__list_id__pipelines_get";
+  listPipelineStepOptions: "list_pipeline_step_options_enrichment_lists__list_id__pipeline_step_options_get";
+  listPipelineTemplates: "list_pipeline_templates_enrichment_lists_pipeline_templates_get";
+  listQualificationTemplates: "list_qualification_templates_enrichment_ai_qualification_templates_get";
+  listRecordSyncFields: "list_record_sync_fields_enrichment_record_sync__entity_type__fields_get";
+  listRecordSyncHistory: "list_record_sync_history_enrichment_record_sync__entity_type__history_get";
+  listRecordSyncLists: "list_record_sync_lists_enrichment_record_sync__entity_type__lists_get";
+  listRoutingRules: "list_routing_rules_enrichment_list_routing_rules_get";
+  listWaterfallAllowedColumns: "list_waterfall_allowed_columns_enrichment_waterfall_allowed_columns_get";
+  listWaterfallConfigs: "list_waterfall_configs_enrichment_waterfall_configs_get";
+  listWaterfallTemplates: "list_waterfall_templates_enrichment_waterfall_templates_get";
+  lookupCompany: "lookup_company_enrichment_lookup_company_post";
+  lookupPerson: "lookup_person_enrichment_lookup_person_post";
+  lookupPersonAlias: "lookup_person_alias_enrichment_person_post";
+  pauseEnrichmentJob: "pause_enrichment_job_enrichment_jobs__job_id__pause_post";
+  previewFindPeople: "preview_find_people_enrichment_find_people__config_id__preview_post";
+  previewFormula: "preview_formula_enrichment_ai_formula_preview_post";
+  previewRecordSync: "preview_record_sync_enrichment_record_sync__entity_type__preview_post";
+  previewRoutingRule: "preview_routing_rule_enrichment_list_routing_rules_preview_post";
+  renameAiEnrichmentColumn: "rename_ai_enrichment_column_enrichment_ai_configs__group_id__rename_put";
+  resumeEnrichmentJob: "resume_enrichment_job_enrichment_jobs__job_id__resume_post";
+  reviewRecordSyncChange: "review_record_sync_change_enrichment_record_sync__entity_type__review_post";
+  runAiEnrichment: "run_ai_enrichment_enrichment_ai_enrich_post";
+  runFindPeople: "run_find_people_enrichment_find_people__config_id__run_post";
+  runFormulaColumn: "run_formula_column_enrichment_formula_configs__column_id__run_post";
+  runListPipeline: "run_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__runs_post";
+  runQualification: "run_qualification_enrichment_ai_qualification_run_post";
+  runRecordSync: "run_record_sync_enrichment_record_sync__entity_type__run_post";
+  runWaterfallPipeline: "run_waterfall_pipeline_enrichment_waterfall_enrich_post";
+  saveAiEnrichmentConfig: "save_ai_enrichment_config_enrichment_ai_configs_post";
+  searchImportFindPeople: "search_import_find_people_enrichment_find_people_search_import_post";
+  setPipelineEnabled: "set_pipeline_enabled_enrichment_lists__list_id__pipelines__pipeline_id__enabled_post";
+  startAiBatchEnrichment: "start_ai_batch_enrichment_enrichment_ai_batch_enrich_post";
+  startEnrichment: "start_enrichment_enrichment_enrich_post";
+  unassignConfigFromList: "unassign_config_from_list_enrichment_configs__config_id__assignments__list_id__delete";
+  updateAiConfiguration: "update_ai_configuration_enrichment_ai_configs__group_id__put";
+  updateAutoEnrichmentConfig: "update_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__patch";
+  updateAutoEnrichmentSettings: "update_auto_enrichment_settings_enrichment_auto_enrichment_settings__entity_type__put";
+  updateEnrichmentConfig: "update_enrichment_config_enrichment_configs__config_id__put";
+  updateEnrichmentField: "update_enrichment_field_enrichment_records__record_id__fields__column_id__patch";
+  updateFindPeopleConfig: "update_find_people_config_enrichment_find_people__config_id__put";
+  updateFormulaConfiguration: "update_formula_configuration_enrichment_formula_configs__column_id__put";
+  updateListPipeline: "update_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__put";
+  updateQualificationTemplate: "update_qualification_template_enrichment_ai_qualification_templates__template_id__put";
+  updateRecordSyncPolicy: "update_record_sync_policy_enrichment_record_sync__entity_type__policy_put";
+  updateWaterfallConfiguration: "update_waterfall_configuration_enrichment_waterfall_configs__column_id__put";
+  validateAiEnrichmentCredits: "validate_ai_enrichment_credits_enrichment_ai_validate_credits_post";
+  validateFormula: "validate_formula_enrichment_ai_formula_validate_post";
+  validateWaterfallEnrichmentCredits: "validate_waterfall_enrichment_credits_enrichment_waterfall_validate_credits_post";
+  verifyEmail: "verify_email_enrichment_verify_email_post";
+}
+
+/** Input and output of every `g8.api.enrichment` operation, keyed by operationId. */
+export interface EnrichmentOperations {
+  /**
+   * POST /enrichment/configs/{config_id}/assignments
+   * Assign Enrichment Configuration
+   * tier: write · scope: enrichment:write
+   */
+  assign_enrichment_configuration_enrichment_configs__config_id__assignments_post: {
+    input: {
+    path: {
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AssignListsRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/jobs/{job_id}/cancel
+   * Cancel Enrichment Job
+   * tier: write · scope: enrichment:write
+   */
+  cancel_enrichment_job_enrichment_jobs__job_id__cancel_post: {
+    input: {
+    path: {
+      /** Enrichment job id (UUID). */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: JobControlRequest | null;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/{pipeline_id}/cancel
+   * Cancel List Pipeline Run
+   * tier: write · scope: enrichment:write
+   */
+  cancel_list_pipeline_run_enrichment_lists__list_id__pipelines__pipeline_id__cancel_post: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/find-people/configure
+   * Configure Find People
+   * tier: billable · scope: enrichment:run
+   */
+  configure_find_people_enrichment_find_people_configure_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ConfigureFindPeopleRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/auto-enrichment/configs
+   * Create Auto Enrichment Config
+   * tier: billable · scope: enrichment:run
+   */
+  create_auto_enrichment_config_enrichment_auto_enrichment_configs_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateAutoEnrichmentConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/waterfall/configs
+   * Create Default Waterfall Config
+   * tier: billable · scope: enrichment:run
+   */
+  create_default_waterfall_config_enrichment_waterfall_configs_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateDefaultWaterfallConfigRequest;
+  };
+    output: ApiResponse_CreateDefaultWaterfallConfigResponse_;
+  };
+  /**
+   * POST /enrichment/columns
+   * Create Dynamic Column
+   * tier: write · scope: enrichment:write
+   */
+  create_dynamic_column_enrichment_columns_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateDynamicColumnRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/configs
+   * Create Enrichment Configuration
+   * tier: write · scope: enrichment:write
+   */
+  create_enrichment_configuration_enrichment_configs_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateEnrichmentConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/formula/configs/{column_id}
+   * Create Formula Config
+   * tier: write · scope: enrichment:write
+   */
+  create_formula_config_enrichment_formula_configs__column_id__post: {
+    input: {
+    path: {
+      /** Column the formula fills. */
+      column_id: string;
+    };
+    query?: {
+      /** Scope the formula to one list. Omit for a global one. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateFormulaConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/formula-templates
+   * Create Formula Template
+   * tier: write · scope: enrichment:write
+   */
+  create_formula_template_enrichment_formula_templates_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateFormulaTemplateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines
+   * Create List Pipeline
+   * tier: billable · scope: enrichment:run
+   */
+  create_list_pipeline_enrichment_lists__list_id__pipelines_post: {
+    input: {
+    path: {
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SaveListPipelineRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/from-template
+   * Create List Pipeline From Template
+   * tier: write · scope: enrichment:write
+   */
+  create_list_pipeline_from_template_enrichment_lists__list_id__pipelines_from_template_post: {
+    input: {
+    path: {
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: InstantiatePipelineTemplateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/list-routing/rules
+   * Create Routing Rule
+   * tier: write · scope: enrichment:write
+   */
+  create_routing_rule_enrichment_list_routing_rules_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateRoutingRuleRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/ai/configs/{group_id}/columns/{column_id}
+   * Delete Ai Config By Column
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_ai_config_by_column_enrichment_ai_configs__group_id__columns__column_id__delete: {
+    input: {
+    path: {
+      /** AI group id. */
+      group_id: string;
+      /** The single column to drop. */
+      column_id: string;
+    };
+    query?: {
+      /** Remove the configuration permanently instead of deactivating it. The values it already wrote are kept either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/ai/configs/{group_id}
+   * Delete Ai Config By Group
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_ai_config_by_group_enrichment_ai_configs__group_id__delete: {
+    input: {
+    path: {
+      /** AI group id. */
+      group_id: string;
+    };
+    query?: {
+      /** Remove the configuration permanently instead of deactivating it. The values it already wrote are kept either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/auto-enrichment/configs/{config_id}
+   * Delete Auto Enrichment Config
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__delete: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/configs/{config_id}
+   * Delete Enrichment Config
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_enrichment_config_enrichment_configs__config_id__delete: {
+    input: {
+    path: {
+      /** Enrichment configuration id (UUID). */
+      config_id: string;
+    };
+    query?: {
+      /** Remove the configuration permanently instead of deactivating it. The values it already wrote are kept either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/find-people/{config_id}
+   * Delete Find People Config
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_find_people_config_enrichment_find_people__config_id__delete: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    query?: {
+      /** TRUE BY DEFAULT, matching the app: the configuration is removed permanently rather than deactivated. Pass false to keep it. Contacts already imported are unaffected either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/formula/configs/{column_id}
+   * Delete Formula Config
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_formula_config_enrichment_formula_configs__column_id__delete: {
+    input: {
+    path: {
+      /** Column the formula fills. */
+      column_id: string;
+    };
+    query?: {
+      /** Remove the configuration permanently instead of deactivating it. The values it already wrote are kept either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/lists/{list_id}/pipelines/{pipeline_id}
+   * Delete List Pipeline
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__delete: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/list-routing/rules/{rule_id}
+   * Delete Routing Rule
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_routing_rule_enrichment_list_routing_rules__rule_id__delete: {
+    input: {
+    path: {
+      /** Routing rule id (UUID). */
+      rule_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * DELETE /enrichment/waterfall/configs/{column_id}
+   * Delete Waterfall Config
+   * tier: destructive · scope: enrichment:delete
+   */
+  delete_waterfall_config_enrichment_waterfall_configs__column_id__delete: {
+    input: {
+    path: {
+      /** Waterfall column id. */
+      column_id: string;
+    };
+    query?: {
+      /** Remove the configuration permanently instead of deactivating it. The values it already wrote are kept either way. */
+      hard_delete?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/ai-draft
+   * Draft Pipeline With Ai
+   * tier: billable · scope: enrichment:run
+   */
+  draft_pipeline_with_ai_enrichment_lists__list_id__pipelines_ai_draft_post: {
+    input: {
+    path: {
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIPipelineDraftRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/qualification/estimate-all
+   * Estimate All Qualification Templates
+   * tier: read · scope: enrichment:read
+   */
+  estimate_all_qualification_templates_enrichment_ai_qualification_estimate_all_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EstimateAllRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/{pipeline_id}/estimate
+   * Estimate List Pipeline
+   * tier: read · scope: enrichment:read
+   */
+  estimate_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__estimate_post: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/qualification/estimate
+   * Estimate Qualification
+   * tier: read · scope: enrichment:read
+   */
+  estimate_qualification_enrichment_ai_qualification_estimate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RunQualificationRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/list-routing/rules/{rule_id}/execute
+   * Execute Routing Rule
+   * tier: write · scope: enrichment:write
+   */
+  execute_routing_rule_enrichment_list_routing_rules__rule_id__execute_post: {
+    input: {
+    path: {
+      /** Routing rule id (UUID). */
+      rule_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai-formula/generate-condition
+   * Generate Ai Run Condition
+   * tier: billable · scope: enrichment:run
+   */
+  generate_ai_run_condition_enrichment_ai_formula_generate_condition_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIRunConditionRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/generate-prompt
+   * Generate Enrichment Prompt
+   * tier: billable · scope: enrichment:run
+   */
+  generate_enrichment_prompt_enrichment_generate_prompt_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PromptGeneratorRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai-formula/generate
+   * Generate Formula With Ai
+   * tier: billable · scope: enrichment:run
+   */
+  generate_formula_with_ai_enrichment_ai_formula_generate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIFormulaGenerateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/qualification/generate-templates
+   * Generate Qualification Templates
+   * tier: billable · scope: enrichment:run
+   */
+  generate_qualification_templates_enrichment_ai_qualification_generate_templates_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/list-routing/generate-filter
+   * Generate Routing Filter
+   * tier: billable · scope: enrichment:run
+   */
+  generate_routing_filter_enrichment_list_routing_generate_filter_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: GenerateFilterRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/ai/batch/jobs/{job_id}/status
+   * Get Ai Batch Job Status
+   * tier: read · scope: enrichment:read
+   */
+  get_ai_batch_job_status_enrichment_ai_batch_jobs__job_id__status_get: {
+    input: {
+    path: {
+      /** The batch job id. */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/ai/configs/{group_id}
+   * Get Ai Configuration
+   * tier: read · scope: enrichment:read
+   */
+  get_ai_configuration_enrichment_ai_configs__group_id__get: {
+    input: {
+    path: {
+      /** The AI group id. */
+      group_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/auto-enrichment/configs/{config_id}
+   * Get Auto Enrichment Config
+   * tier: read · scope: enrichment:read
+   */
+  get_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__get: {
+    input: {
+    path: {
+      /** Auto-enrichment config id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/auto-enrichment/settings
+   * Get Auto Enrichment Settings
+   * tier: read · scope: enrichment:read
+   */
+  get_auto_enrichment_settings_enrichment_auto_enrichment_settings_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/companies/gtm-profile
+   * Get Company Gtm Profile
+   * tier: read · scope: enrichment:read
+   */
+  get_company_gtm_profile_enrichment_companies_gtm_profile_get: {
+    input: {
+    query: {
+      /** Company domain to look up. */
+      domain: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/configs/{config_id}
+   * Get Enrichment Configuration
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_configuration_enrichment_configs__config_id__get: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/analytics/daily-activity
+   * Get Enrichment Daily Activity
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_daily_activity_enrichment_analytics_daily_activity_get: {
+    input: {
+    query?: {
+      /** Reporting window. */
+      period?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/analytics/field-distribution
+   * Get Enrichment Field Distribution
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_field_distribution_enrichment_analytics_field_distribution_get: {
+    input: {
+    query?: {
+      /** Reporting window. */
+      period?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/jobs/{job_id}
+   * Get Enrichment Job
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_job_enrichment_jobs__job_id__get: {
+    input: {
+    path: {
+      job_id: string;
+    };
+    query?: {
+      /** When true, include per-provider step errors (record_id, provider, error) from the job records, e.g. '<provider> API key is not configured'. Adds one DB read; off by default. */
+      include_provider_errors?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichJobResponse_;
+  };
+  /**
+   * GET /enrichment/analytics/metrics
+   * Get Enrichment Metrics
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_metrics_enrichment_analytics_metrics_get: {
+    input: {
+    query?: {
+      period?: "last_7_days" | "last_30_days" | "last_90_days" | "current_month" | "last_month";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/records/progress
+   * Get Enrichment Records Progress
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_records_progress_enrichment_records_progress_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RecordProgressRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/analytics/trends
+   * Get Enrichment Trends
+   * tier: read · scope: enrichment:read
+   */
+  get_enrichment_trends_enrichment_analytics_trends_get: {
+    input: {
+    query?: {
+      period?: "last_7_days" | "last_30_days" | "last_90_days" | "current_month" | "last_month";
+      granularity?: "day" | "week" | "month";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/find-people/{config_id}
+   * Get Find People Config
+   * tier: read · scope: enrichment:read
+   */
+  get_find_people_config_enrichment_find_people__config_id__get: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/find-people/{config_id}/results/{company_id}
+   * Get Find People Results
+   * tier: read · scope: enrichment:read
+   */
+  get_find_people_results_enrichment_find_people__config_id__results__company_id__get: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+      /** Which company's results to read. */
+      company_id: number;
+    };
+    query?: {
+      /** Narrow to one result status. */
+      status?: string | null;
+      page?: number;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/formula/configs/{column_id}
+   * Get Formula Configuration
+   * tier: read · scope: enrichment:read
+   */
+  get_formula_configuration_enrichment_formula_configs__column_id__get: {
+    input: {
+    path: {
+      /** The enrichment column id. */
+      column_id: string;
+    };
+    query?: {
+      /** Scope to a list's configuration. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/lists/pipeline-runs/{run_id}
+   * Get Pipeline Run
+   * tier: read · scope: enrichment:read
+   */
+  get_pipeline_run_enrichment_lists_pipeline_runs__run_id__get: {
+    input: {
+    path: {
+      /** Pipeline run id. */
+      run_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/ai/qualification/fit-landscape
+   * Get Qualification Fit Landscape
+   * tier: read · scope: enrichment:read
+   */
+  get_qualification_fit_landscape_enrichment_ai_qualification_fit_landscape_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/record-sync/{entity_type}/status
+   * Get Record Sync Status
+   * tier: read · scope: enrichment:read
+   */
+  get_record_sync_status_enrichment_record_sync__entity_type__status_get: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/list-routing/rules/{rule_id}
+   * Get Routing Rule
+   * tier: read · scope: enrichment:read
+   */
+  get_routing_rule_enrichment_list_routing_rules__rule_id__get: {
+    input: {
+    path: {
+      /** Routing rule id (UUID). */
+      rule_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/waterfall/configs/{column_id}
+   * Get Waterfall Configuration
+   * tier: read · scope: enrichment:read
+   */
+  get_waterfall_configuration_enrichment_waterfall_configs__column_id__get: {
+    input: {
+    path: {
+      /** The enrichment column id. */
+      column_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/waterfall/jobs/{job_id}/progress
+   * Get Waterfall Job Progress
+   * tier: read · scope: enrichment:read
+   */
+  get_waterfall_job_progress_enrichment_waterfall_jobs__job_id__progress_get: {
+    input: {
+    path: {
+      /** Waterfall job id. */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/find-people/{config_id}/import
+   * Import Find People Results
+   * tier: billable · scope: enrichment:run
+   */
+  import_find_people_results_enrichment_find_people__config_id__import_post: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: ImportFindPeopleRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/active-jobs
+   * List Active Enrichment Jobs
+   * tier: read · scope: enrichment:read
+   */
+  list_active_enrichment_jobs_enrichment_active_jobs_get: {
+    input: {
+    query?: {
+      /** Only jobs on this list. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/ai/configs
+   * List Ai Configs
+   * tier: read · scope: enrichment:read
+   */
+  list_ai_configs_enrichment_ai_configs_get: {
+    input: {
+    query: {
+      /** List ID whose saved AI configs to return */
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AIConfigsResponse_;
+  };
+  /**
+   * GET /enrichment/ai-formula/available-fields
+   * List Ai Formula Available Fields
+   * tier: read · scope: enrichment:read
+   */
+  list_ai_formula_available_fields_enrichment_ai_formula_available_fields_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/ai-templates
+   * List Ai Templates
+   * tier: read · scope: enrichment:read
+   */
+  list_ai_templates_enrichment_ai_templates_get: {
+    input: {
+    query: {
+      /** Templates applicable to this list. */
+      list_id: number;
+      /** Narrow to one category. */
+      category?: string | null;
+      /** Include graph8's built-in templates as well as the org's own. */
+      include_system_templates?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/auto-enrichment/configs
+   * List Auto Enrichment Configs
+   * tier: read · scope: enrichment:read
+   */
+  list_auto_enrichment_configs_enrichment_auto_enrichment_configs_get: {
+    input: {
+    query?: {
+      /** Only this list's configs. */
+      audience_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/configs/{config_id}/assignments
+   * List Config Assignments
+   * tier: read · scope: enrichment:read
+   */
+  list_config_assignments_enrichment_configs__config_id__assignments_get: {
+    input: {
+    path: {
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/configs
+   * List Enrichment Configurations
+   * tier: read · scope: enrichment:read
+   */
+  list_enrichment_configurations_enrichment_configs_get: {
+    input: {
+    query?: {
+      /** Filter by type, e.g. `ai`, `waterfall`. */
+      config_type?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/providers
+   * List Enrichment Providers
+   * tier: read · scope: enrichment:read
+   */
+  list_enrichment_providers_enrichment_providers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ProviderCatalogResponse_;
+  };
+  /**
+   * GET /enrichment/formula-templates
+   * List Formula Templates
+   * tier: read · scope: enrichment:read
+   */
+  list_formula_templates_enrichment_formula_templates_get: {
+    input: {
+    query: {
+      /** Templates applicable to this list. */
+      list_id: number;
+      /** Narrow to one category. */
+      category?: string | null;
+      /** Include graph8's built-in templates as well as the org's own. */
+      include_system_templates?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs
+   * List List Pipeline Runs
+   * tier: read · scope: enrichment:read
+   */
+  list_list_pipeline_runs_enrichment_lists__list_id__pipelines__pipeline_id__runs_get: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    query?: {
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/lists/{list_id}/pipelines
+   * List List Pipelines
+   * tier: read · scope: enrichment:read
+   */
+  list_list_pipelines_enrichment_lists__list_id__pipelines_get: {
+    input: {
+    path: {
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/lists/{list_id}/pipeline-step-options
+   * List Pipeline Step Options
+   * tier: read · scope: enrichment:read
+   */
+  list_pipeline_step_options_enrichment_lists__list_id__pipeline_step_options_get: {
+    input: {
+    path: {
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/lists/pipeline-templates
+   * List Pipeline Templates
+   * tier: read · scope: enrichment:read
+   */
+  list_pipeline_templates_enrichment_lists_pipeline_templates_get: {
+    input: {
+    query?: {
+      /** Templates applicable to this list. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/ai/qualification/templates
+   * List Qualification Templates
+   * tier: read · scope: enrichment:read
+   */
+  list_qualification_templates_enrichment_ai_qualification_templates_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/record-sync/{entity_type}/fields
+   * List Record Sync Fields
+   * tier: read · scope: enrichment:read
+   */
+  list_record_sync_fields_enrichment_record_sync__entity_type__fields_get: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/record-sync/{entity_type}/history
+   * List Record Sync History
+   * tier: read · scope: enrichment:read
+   */
+  list_record_sync_history_enrichment_record_sync__entity_type__history_get: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    query?: {
+      /** Only deliveries in this state. */
+      state?: string | null;
+      /** Cursor: only deliveries created before this. */
+      before?: string | null;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/record-sync/{entity_type}/lists
+   * List Record Sync Lists
+   * tier: read · scope: enrichment:read
+   */
+  list_record_sync_lists_enrichment_record_sync__entity_type__lists_get: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    query?: {
+      search?: string;
+      /** Cursor: the last list id of the previous page. */
+      after?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/list-routing/rules
+   * List Routing Rules
+   * tier: read · scope: enrichment:read
+   */
+  list_routing_rules_enrichment_list_routing_rules_get: {
+    input: {
+    query?: {
+      /** Only rules reading this list. */
+      source_list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentListPayload_;
+  };
+  /**
+   * GET /enrichment/waterfall/allowed-columns
+   * List Waterfall Allowed Columns
+   * tier: read · scope: enrichment:read
+   */
+  list_waterfall_allowed_columns_enrichment_waterfall_allowed_columns_get: {
+    input: {
+    query: {
+      /** Which list's columns to report. */
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * GET /enrichment/waterfall/configs
+   * List Waterfall Configs
+   * tier: read · scope: enrichment:read
+   */
+  list_waterfall_configs_enrichment_waterfall_configs_get: {
+    input: {
+    query: {
+      /** List ID whose saved pipelines to return */
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WaterfallConfigsResponse_;
+  };
+  /**
+   * GET /enrichment/waterfall/templates
+   * List Waterfall Templates
+   * tier: read · scope: enrichment:read
+   */
+  list_waterfall_templates_enrichment_waterfall_templates_get: {
+    input: {
+    query?: {
+      /** One field, e.g. `CONTACT_WORK_EMAIL`. */
+      field?: string | null;
+      /** Only templates for this list's record type. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lookup/company
+   * Lookup Company
+   * tier: billable · scope: enrichment:run
+   */
+  lookup_company_enrichment_lookup_company_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CompanyLookupRequest;
+  };
+    output: ApiResponse_LookupResponse_;
+  };
+  /**
+   * POST /enrichment/lookup/person
+   * Lookup Person
+   * tier: billable · scope: enrichment:run
+   */
+  lookup_person_enrichment_lookup_person_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonLookupRequest;
+  };
+    output: ApiResponse_LookupResponse_;
+  };
+  /**
+   * POST /enrichment/person
+   * Lookup Person (alias of /enrichment/lookup/person)
+   * tier: billable · scope: enrichment:run
+   */
+  lookup_person_alias_enrichment_person_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonLookupRequest;
+  };
+    output: ApiResponse_LookupResponse_;
+  };
+  /**
+   * POST /enrichment/jobs/{job_id}/pause
+   * Pause Enrichment Job
+   * tier: write · scope: enrichment:write
+   */
+  pause_enrichment_job_enrichment_jobs__job_id__pause_post: {
+    input: {
+    path: {
+      /** Enrichment job id (UUID). */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: JobControlRequest | null;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/find-people/{config_id}/preview
+   * Preview Find People
+   * tier: billable · scope: enrichment:run
+   */
+  preview_find_people_enrichment_find_people__config_id__preview_post: {
+    input: {
+    path: {
+      /** Find-people configuration id (UUID). */
+      config_id: string;
+    };
+    query: {
+      /** The company to preview. */
+      company_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai-formula/preview
+   * Preview Formula
+   * tier: read · scope: enrichment:read
+   */
+  preview_formula_enrichment_ai_formula_preview_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIFormulaPreviewRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/record-sync/{entity_type}/preview
+   * Preview Record Sync
+   * tier: read · scope: enrichment:read
+   */
+  preview_record_sync_enrichment_record_sync__entity_type__preview_post: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RecordSyncPreviewRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/list-routing/rules/preview
+   * Preview Routing Rule
+   * tier: read · scope: enrichment:read
+   */
+  preview_routing_rule_enrichment_list_routing_rules_preview_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PreviewRoutingRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/ai/configs/{group_id}/rename
+   * Rename Ai Enrichment Column
+   * tier: write · scope: enrichment:write
+   */
+  rename_ai_enrichment_column_enrichment_ai_configs__group_id__rename_put: {
+    input: {
+    path: {
+      /** AI group id. */
+      group_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RenameAIColumnRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/jobs/{job_id}/resume
+   * Resume Enrichment Job
+   * tier: billable · scope: enrichment:run
+   */
+  resume_enrichment_job_enrichment_jobs__job_id__resume_post: {
+    input: {
+    path: {
+      /** Enrichment job id (UUID). */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/record-sync/{entity_type}/review
+   * Review Record Sync Change
+   * tier: write · scope: enrichment:write
+   */
+  review_record_sync_change_enrichment_record_sync__entity_type__review_post: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ReviewRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/enrich
+   * Run Ai Enrichment
+   * tier: billable · scope: enrichment:run
+   */
+  run_ai_enrichment_enrichment_ai_enrich_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RunAIEnrichRequest;
+  };
+    output: ApiResponse_EnrichJobResponse_;
+  };
+  /**
+   * POST /enrichment/find-people/{config_id}/run
+   * Run Find People
+   * tier: billable · scope: enrichment:run
+   */
+  run_find_people_enrichment_find_people__config_id__run_post: {
+    input: {
+    path: {
+      /** Find-people configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RunFindPeopleRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/formula/configs/{column_id}/run
+   * Run Formula Column
+   * tier: write · scope: enrichment:write
+   */
+  run_formula_column_enrichment_formula_configs__column_id__run_post: {
+    input: {
+    path: {
+      /** The enrichment column id. */
+      column_id: string;
+    };
+    query?: {
+      /** Scope to a list's configuration. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: RunFormulaRequest | null;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs
+   * Run List Pipeline
+   * tier: billable · scope: enrichment:run
+   */
+  run_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__runs_post: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/qualification/run
+   * Run Qualification
+   * tier: billable · scope: enrichment:run
+   */
+  run_qualification_enrichment_ai_qualification_run_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RunQualificationRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/record-sync/{entity_type}/run
+   * Run Record Sync
+   * tier: billable · scope: enrichment:run
+   */
+  run_record_sync_enrichment_record_sync__entity_type__run_post: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RecordSyncRunRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/waterfall/enrich
+   * Run Waterfall Pipeline
+   * tier: billable · scope: enrichment:run
+   */
+  run_waterfall_pipeline_enrichment_waterfall_enrich_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RunWaterfallEnrichRequest;
+  };
+    output: ApiResponse_EnrichJobResponse_;
+  };
+  /**
+   * POST /enrichment/ai/configs
+   * Save Ai Enrichment Config
+   * tier: write · scope: enrichment:write
+   */
+  save_ai_enrichment_config_enrichment_ai_configs_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SaveAIConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/find-people/search-import
+   * Search Import Find People
+   * tier: billable · scope: enrichment:run
+   */
+  search_import_find_people_enrichment_find_people_search_import_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SearchImportRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/lists/{list_id}/pipelines/{pipeline_id}/enabled
+   * Set Pipeline Enabled
+   * tier: billable · scope: enrichment:run
+   */
+  set_pipeline_enabled_enrichment_lists__list_id__pipelines__pipeline_id__enabled_post: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetPipelineEnabledRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/batch/enrich
+   * Start Ai Batch Enrichment
+   * tier: billable · scope: enrichment:run
+   */
+  start_ai_batch_enrichment_enrichment_ai_batch_enrich_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIBatchEnrichmentRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/enrich
+   * Start Enrichment
+   * tier: billable · scope: enrichment:run
+   */
+  start_enrichment_enrichment_enrich_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EnrichRequest;
+  };
+    output: ApiResponse_EnrichJobResponse_;
+  };
+  /**
+   * DELETE /enrichment/configs/{config_id}/assignments/{list_id}
+   * Unassign Config From List
+   * tier: destructive · scope: enrichment:delete
+   */
+  unassign_config_from_list_enrichment_configs__config_id__assignments__list_id__delete: {
+    input: {
+    path: {
+      config_id: string;
+      list_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/ai/configs/{group_id}
+   * Update Ai Configuration
+   * tier: write · scope: enrichment:write
+   */
+  update_ai_configuration_enrichment_ai_configs__group_id__put: {
+    input: {
+    path: {
+      /** The AI group id. */
+      group_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateAIConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PATCH /enrichment/auto-enrichment/configs/{config_id}
+   * Update Auto Enrichment Config
+   * tier: billable · scope: enrichment:run
+   */
+  update_auto_enrichment_config_enrichment_auto_enrichment_configs__config_id__patch: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateAutoEnrichmentConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/auto-enrichment/settings/{entity_type}
+   * Update Auto Enrichment Settings
+   * tier: billable · scope: enrichment:run
+   */
+  update_auto_enrichment_settings_enrichment_auto_enrichment_settings__entity_type__put: {
+    input: {
+    path: {
+      /** Which record kind. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateAutoEnrichmentSettingsRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/configs/{config_id}
+   * Update Enrichment Config
+   * tier: write · scope: enrichment:write
+   */
+  update_enrichment_config_enrichment_configs__config_id__put: {
+    input: {
+    path: {
+      /** Enrichment configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EnrichmentConfigUpdateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PATCH /enrichment/records/{record_id}/fields/{column_id}
+   * Update Enrichment Field
+   * tier: write · scope: enrichment:write
+   */
+  update_enrichment_field_enrichment_records__record_id__fields__column_id__patch: {
+    input: {
+    path: {
+      /** Record id. */
+      record_id: number;
+      /** Enrichment column id. */
+      column_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateEnrichmentFieldRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/find-people/{config_id}
+   * Update Find People Config
+   * tier: write · scope: enrichment:write
+   */
+  update_find_people_config_enrichment_find_people__config_id__put: {
+    input: {
+    path: {
+      /** Configuration id (UUID). */
+      config_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateFindPeopleConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/formula/configs/{column_id}
+   * Update Formula Configuration
+   * tier: write · scope: enrichment:write
+   */
+  update_formula_configuration_enrichment_formula_configs__column_id__put: {
+    input: {
+    path: {
+      /** The enrichment column id. */
+      column_id: string;
+    };
+    query?: {
+      /** Scope to a list's configuration. */
+      list_id?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateFormulaConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/lists/{list_id}/pipelines/{pipeline_id}
+   * Update List Pipeline
+   * tier: billable · scope: enrichment:run
+   */
+  update_list_pipeline_enrichment_lists__list_id__pipelines__pipeline_id__put: {
+    input: {
+    path: {
+      list_id: number;
+      /** Pipeline id (UUID). */
+      pipeline_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateListPipelineRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/ai/qualification/templates/{template_id}
+   * Update Qualification Template
+   * tier: write · scope: enrichment:write
+   */
+  update_qualification_template_enrichment_ai_qualification_templates__template_id__put: {
+    input: {
+    path: {
+      /** Qualification template id (UUID). */
+      template_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateQualificationTemplateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/record-sync/{entity_type}/policy
+   * Update Record Sync Policy
+   * tier: billable · scope: enrichment:run
+   */
+  update_record_sync_policy_enrichment_record_sync__entity_type__policy_put: {
+    input: {
+    path: {
+      /** Which record kind this policy governs. */
+      entity_type: "contact" | "company";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateMashupSyncPolicyRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * PUT /enrichment/waterfall/configs/{column_id}
+   * Update Waterfall Configuration
+   * tier: billable · scope: enrichment:run
+   */
+  update_waterfall_configuration_enrichment_waterfall_configs__column_id__put: {
+    input: {
+    path: {
+      /** The enrichment column id. */
+      column_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateWaterfallConfigRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai/validate-credits
+   * Validate Ai Enrichment Credits
+   * tier: read · scope: enrichment:read
+   */
+  validate_ai_enrichment_credits_enrichment_ai_validate_credits_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ValidateCreditsRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/ai-formula/validate
+   * Validate Formula
+   * tier: read · scope: enrichment:read
+   */
+  validate_formula_enrichment_ai_formula_validate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AIFormulaValidateRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/waterfall/validate-credits
+   * Validate Waterfall Enrichment Credits
+   * tier: read · scope: enrichment:read
+   */
+  validate_waterfall_enrichment_credits_enrichment_waterfall_validate_credits_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ValidateWaterfallCreditsRequest;
+  };
+    output: ApiResponse_EnrichmentPayload_;
+  };
+  /**
+   * POST /enrichment/verify-email
+   * Verify Email
+   * tier: billable · scope: enrichment:run
+   */
+  verify_email_enrichment_verify_email_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VerifyEmailRequest;
+  };
+    output: ApiResponse_VerifyEmailResponse_;
+  };
+}
+
+// 102 schemas referenced above (the same as G8Contract.<Name>).
+
+/**
+ * Run a saved AI group over a list. CHARGES per record.
+ *
+ * `enrichment_mode: all` runs EVERY record in the list; `specific` runs only
+ * `record_ids`. `dry_run` returns the record count and price and dispatches
+ * nothing.
+ */
+export interface AIBatchEnrichmentRequest {
+  /** Accepted; not applied by dispatch. */
+  allow_credit_deduction?: boolean;
+  dry_run?: boolean;
+  enrichment_mode?: "specific" | "all";
+  /** Accepted; not applied by dispatch. */
+  filter?: Record<string, unknown> | null;
+  group_id: string;
+  list_id: number;
+  model?: string | null;
+  /** Accepted; not applied by dispatch. */
+  priority?: number;
+  record_ids?: (Array<number | string>) | null;
+  skip_existing_values?: boolean;
+  skip_recently_enriched?: boolean;
+  usecase?: string | null;
+}
+
+/** Where one output field lands. */
+export interface AIColumnMappingDto {
+  column_id: string;
+  column_name: string;
+  output_field: string;
+}
+
+/** Execution settings for an AI enrichment group. */
+export interface AIConfigDto {
+  /** Re-run when new data arrives. ONGOING SPEND when true. */
+  auto_update?: boolean;
+  find_people?: AIFindPeopleSettingsDto | null;
+  list_routing?: ListRoutingDto | null;
+  mode?: "standard" | "find_people";
+  run_condition?: string | null;
+  scope?: ("company" | "contact" | "combined") | null;
+  /** Skip rows that already have a value - the main cost control. */
+  skip_existing_values?: boolean;
+  /** Skip rows enriched in the last 30 days. */
+  skip_recently_enriched?: boolean;
+  use_advanced_search?: boolean;
+  use_json?: boolean;
+}
+
+/**
+ * One saved AI enrichment config attached to (or global for) a list.
+ *
+ * `group_id` is the handle the worker uses to load the prompt, model and
+ * output mapping. `usecase` lets the client predict credit cost via
+ * enrichment.constants.AI_USECASE_CREDITS (e.g. web-research = 3 credits/record).
+ */
+export interface AIConfigSummary {
+  group_id: string;
+  is_active?: boolean;
+  is_global?: boolean;
+  list_id?: number | null;
+  name: string;
+  /** Use-case identifier (e.g. "web-research", "content-generation"). */
+  usecase?: string | null;
+}
+
+/** Paginated (by list_id filter) collection of AI enrichment configs. */
+export interface AIConfigsResponse {
+  configs?: Array<AIConfigSummary>;
+  count?: number;
+  list_id?: number | null;
+}
+
+/** A full AI enrichment group definition. */
+export interface AIEnrichmentConfigDto {
+  column_mappings?: Array<AIColumnMappingDto>;
+  config: AIConfigDto;
+  created_at?: string | null;
+  created_by?: string | null;
+  description?: string | null;
+  group_id?: string | null;
+  id?: string | null;
+  input_mapping: Array<string>;
+  is_global?: boolean;
+  json_schema?: (Record<string, "string" | "number" | "boolean">) | null;
+  list_id?: number | null;
+  model: string;
+  name?: string | null;
+  org_id?: string | null;
+  output_format?: string;
+  outputs: Array<AIOutputFieldDto>;
+  prompt: string;
+  updated_at?: string | null;
+  usecase: string;
+}
+
+/** Find-people mode settings for an AI group. */
+export interface AIFindPeopleSettingsDto {
+  destination_table_id?: string | null;
+  destination_table_name?: string | null;
+  /** `auto` exports found contacts without a human step; `review` holds them. */
+  export_mode?: "auto" | "review";
+  max_people?: number;
+  review_store?: "source_metadata";
+}
+
+/** Turn a plain-language description into a formula. One model call. */
+export interface AIFormulaGenerateRequest {
+  /** Hint only: fields are read from your data. */
+  fields?: Array<string>;
+  /** Hint for the output kind. */
+  outputType?: string;
+  prompt: string;
+  sampleData?: Record<string, unknown>;
+}
+
+/** Evaluate a formula over sample rows you supply. Local, no model call. */
+export interface AIFormulaPreviewRequest {
+  fields?: Array<string>;
+  formula: string;
+  /** Up to 10 rows are evaluated. */
+  sampleData: Array<Record<string, unknown>>;
+}
+
+/** Check a formula's syntax and field references. */
+export interface AIFormulaValidateRequest {
+  formula: string;
+}
+
+/** One field the AI pass is asked to return. */
+export interface AIOutputFieldDto {
+  name: string;
+  type: string;
+}
+
+/** Draft an enrichment pipeline from a stated goal. Returns a draft only. */
+export interface AIPipelineDraftRequest {
+  goal: string;
+  /** Prefer cheaper steps when drafting. */
+  prioritize_cost?: boolean;
+  qualification_mode?: "auto" | "required" | "skip";
+}
+
+/**
+ * Describe in words when an enrichment should run; get back an expression.
+ *
+ * The app takes a FREE DICT here, so this model takes one too rather than
+ * narrowing below it - every field is optional and unknown keys are forwarded
+ * untouched. Narrowing would refuse a body the browser accepts, which is the
+ * mirror image of the bug the strict models elsewhere in this file prevent.
+ */
+export interface AIRunConditionRequest {
+  /** 'contacts' or 'companies'. */
+  entityType?: string | null;
+  /** Fields the expression may use. */
+  fields?: Array<string> | null;
+  /** The rule in plain words. */
+  prompt?: string | null;
+  /** One sample record. */
+  sampleData?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+export interface ApiResponse_AIConfigsResponse_ {
+  data: AIConfigsResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CreateDefaultWaterfallConfigResponse_ {
+  data: CreateDefaultWaterfallConfigResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_EnrichJobResponse_ {
+  data: EnrichJobResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_EnrichmentListPayload_ {
+  data: EnrichmentListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_EnrichmentPayload_ {
+  data: EnrichmentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_LookupResponse_ {
+  data: LookupResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ProviderCatalogResponse_ {
+  data: ProviderCatalogResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VerifyEmailResponse_ {
+  data: VerifyEmailResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WaterfallConfigsResponse_ {
+  data: WaterfallConfigsResponse;
+  pagination?: PaginationMeta | null;
+}
+
+/** Make a configuration available on more lists. */
+export interface AssignListsRequest {
+  list_ids: Array<number>;
+}
+
+/** Which columns travel with a routed record. */
+export interface ColumnConfigDto {
+  /** 'all' copies every column; 'selected' uses the list below. */
+  mode?: string;
+  selected_column_ids?: Array<string>;
+  static_values?: Record<string, string>;
+}
+
+/** Map a search result field onto a destination column. */
+export interface ColumnMappingDto {
+  source_field: string;
+  target_column: string;
+}
+
+export interface CompanyLookupRequest {
+  /** Company domain */
+  domain?: string | null;
+  /** Company name */
+  name?: string | null;
+}
+
+/** One routing condition. */
+export interface ConditionDto {
+  field: string;
+  operator: string;
+  value?: unknown;
+  value_to?: unknown;
+}
+
+/** Set up a people search across a company list. */
+export interface ConfigureFindPeopleRequest {
+  /** Import results as soon as they are found, with no review step. This is what turns a saved configuration into an immediate run. */
+  auto_import?: boolean;
+  column_mappings?: Array<ColumnMappingDto> | null;
+  company_identifier_column?: string | null;
+  create_new_list?: boolean;
+  destination_list_id?: number | null;
+  /** Source COMPANY list. */
+  list_id: number;
+  max_people_per_company?: number;
+  max_total_people?: number | null;
+  name: string;
+  new_list_name?: string | null;
+  search_filters?: Array<SearchFilterDto>;
+  skip_across_companies?: boolean;
+  skip_existing_in_destination?: boolean;
+}
+
+/** Enrich every record that lands on a list. ARMS ONGOING SPEND. */
+export interface CreateAutoEnrichmentConfigRequest {
+  /** The list. */
+  audience_id: number;
+  /** The waterfall column or AI group id. */
+  column_id: string;
+  enrichment_type: "waterfall" | "ai";
+  trigger_on_insert?: boolean;
+}
+
+/**
+ * Create (or reuse) a waterfall pipeline for a list.
+ *
+ * Three call-styles, in increasing order of control:
+ *
+ * 1. **Bare** — pass only `list_id`. Server builds a single-step graph8
+ *    lookup pipeline that fills name/email/company for 0 credits.
+ *    Backward-compatible with the pre-2026-06 contract.
+ * 2. **By providers** — pass `providers=["hunter","prospeo"]`. Server maps
+ *    each provider to its default email-finder action (see provider matrix
+ *    in `docs/developer-api-reference.md`) and ordered steps. Use this when
+ *    you want a 1-line "try these providers, in this order" pipeline.
+ * 3. **By steps** — pass `steps=[...]` with full step shapes. Server
+ *    persists them verbatim. Use this when you need provider-specific
+ *    config (e.g. apollo `reveal_phone_numbers=true`).
+ *
+ * `providers[]` and `steps[]` are mutually exclusive — pass one or
+ * neither, not both. `email_verification` may be combined with any
+ * call-style; when set it runs after the main waterfall and follows the
+ * same credit + valid-status rules the UI uses.
+ *
+ * `list_id` is required; everything else has a sensible default so callers
+ * pass the minimum. `skip_existing_values` defaults True so we never
+ * overwrite populated fields. Idempotent by `(list_id, name)`.
+ */
+export interface CreateDefaultWaterfallConfigRequest {
+  /** How to resolve each provider step's credential source. Applies to the `providers[]` shortcut and the bare default; `steps[]` payloads always honor their own per-step `is_system_provider`. 'auto' (default, matches the UI): for each provider use the org's BYOK key when one is configured (free), otherwise graph8's system key for funded providers (charges credits). 'system': force graph8 system keys for funded providers (charges credits). 'byok': force the org's own keys for every non-graph8 provider (legacy behavior — steps silently skip when no key exists). graph8 is always system-funded regardless of mode. */
+  credential_mode?: "auto" | "system" | "byok";
+  /** Optional post-enrichment email verification config. When set, ZeroBounce/Hunter/Icypeas/LeadMagic runs after the main waterfall and writes verification status into the column. */
+  email_verification?: EmailVerificationInput | null;
+  /** Canonical enrichment column to fill — CONTACT_DIRECT_PHONE, CONTACT_MOBILE_PHONE, CONTACT_WORK_EMAIL, CONTACT_PERSONAL_EMAILS, CONTACT_LINKEDIN_URL, COMPANY_PHONE, COMPANY_LINKEDIN_URL — or a friendly synonym ('phone', 'mobile', 'email', 'linkedin', 'company_phone'). When set, the pipeline is built from the server's per-field waterfall TEMPLATE, so each provider runs its CORRECT action for that column (e.g. leadmagic `mobile_finder` for a phone, not `email_finder`), and the enriched value is written into the real contact/company column — exactly like the web UI's 'enrich existing column' flow. Combine with `providers[]` to keep only those providers from the template (their correct per-field action is preserved). Mutually exclusive with `steps[]`. When omitted, the legacy bare/`providers[]` email-finder behavior is unchanged. */
+  field?: string | null;
+  /** Target field identifier for this pipeline (legacy; ignored when `field` is set) */
+  field_to_enrich?: string;
+  /** List ID to attach the pipeline to */
+  list_id: number;
+  /** Human-readable name for the pipeline */
+  name?: string;
+  /** Ordered list of provider names — server builds default email-finder steps in this order. Mutually exclusive with `steps`. Allowed providers: graph8, hunter, prospeo, dropcontact, icypeas, leadmagic, emaillistverify, apollo, lusha, rocketreach. Use `steps[]` for full control. */
+  providers?: Array<string> | null;
+  /** If true, the pipeline skips contacts where the target field is already populated */
+  skip_existing_values?: boolean;
+  /** Full caller-supplied step list (advanced). Persisted verbatim into the pipeline. Mutually exclusive with `providers`. */
+  steps?: Array<WaterfallStepInput> | null;
+}
+
+/** Result of creating (or reusing) a default pipeline. */
+export interface CreateDefaultWaterfallConfigResponse {
+  column_id: string;
+  config_id: string;
+  /** True if a new config was created; False if an existing one with the same name was reused */
+  created?: boolean;
+  /** Persisted email_verification block, if any. Mirrors EmailVerificationInput shape. */
+  email_verification?: Record<string, unknown> | null;
+  list_id?: number | null;
+  /** Providers whose step is BYOK but the org has no active key (these steps will be skipped at run time). Empty when every step is runnable. */
+  missing_credentials?: Array<string>;
+  name: string;
+  /** Ordered, de-duplicated provider list of the persisted (or reused) pipeline. */
+  providers?: Array<string>;
+  /** Per-step credential breakdown (system vs BYOK + readiness) for the persisted pipeline. */
+  providers_detail?: Array<ProviderStepDetail>;
+}
+
+/** Add a custom column to a list, or globally. */
+export interface CreateDynamicColumnRequest {
+  data_type?: "text" | "int" | "numeric" | "boolean";
+  /** Omit for a GLOBAL column, visible on every list in the org. */
+  list_id?: number | null;
+  /** Display name of the column. */
+  title: string;
+}
+
+/**
+ * Create an enrichment configuration.
+ *
+ * The app takes this as a free dict and reads these keys. `type` is closed to
+ * the two the handler validates; `ai` requires `group_id`, `prompt`, `model`,
+ * `usecase`, `input_mapping`, `outputs` and `column_mappings` inside
+ * `config`, and `waterfall` requires `column_id`, `field_to_enrich` and
+ * `config.steps`.
+ */
+export interface CreateEnrichmentConfigRequest {
+  column_id?: string | null;
+  config: Record<string, unknown>;
+  data_type?: string;
+  field_to_enrich?: string | null;
+  is_global?: boolean;
+  list_id?: number | null;
+  name: string;
+  type: "ai" | "waterfall";
+}
+
+/** Attach a formula to a column. */
+export interface CreateFormulaConfigRequest {
+  config: FormulaConfigDto;
+  data_type?: string;
+  field_to_enrich: string;
+  name: string;
+}
+
+/** Save a reusable formula-authoring template. */
+export interface CreateFormulaTemplateRequest {
+  category: string;
+  description: string;
+  example_formula?: string | null;
+  field_dependencies: Array<string>;
+  is_system_template?: boolean;
+  name: string;
+  /** 'text', 'number' or 'boolean'. */
+  output_type: string;
+  prompt: string;
+  /** 'companies' or 'contacts'. */
+  target_type: string;
+}
+
+/** Move records from one list to another when they match. */
+export interface CreateRoutingRuleRequest {
+  ai_explanation?: string | null;
+  column_config?: ColumnConfigDto;
+  conditions?: Array<ConditionDto>;
+  dest_list_id?: number | null;
+  /** Create a new destination with this name. */
+  dest_list_name?: string | null;
+  formula_text?: string | null;
+  name: string;
+  /** `continuous` keeps matching NEW records for as long as the rule exists. */
+  schedule_type?: "one_time" | "continuous";
+  source_list_id: number;
+  sync_mode?: "all_matching" | "new_only";
+}
+
+/**
+ * Verify found emails after the waterfall. PAID per address when
+ * `use_system_credentials` is true.
+ */
+export interface EmailVerificationConfig {
+  accept_catchall?: boolean;
+  enabled?: boolean;
+  provider?: "zerobounce" | "hunter" | "icypeas" | "leadmagic" | "emaillistverify";
+  /** Use graph8's provider keys (charges credits) rather than your own. */
+  use_system_credentials?: boolean;
+  valid_statuses?: Array<string>;
+}
+
+/**
+ * Email verification config attached to a waterfall pipeline.
+ *
+ * Mirrors the canonical `EmailVerificationConfigDto` in
+ * `enrichment/interfaces/fastapi/waterfall_dtos.py` so the dev-API and the
+ * UI persist an identical settings shape (the CF worker reads `settings.
+ * email_verification.*` regardless of which surface saved the pipeline).
+ */
+export interface EmailVerificationInput {
+  /** Treat catch-all responses as valid (domains that accept any address). */
+  accept_catchall?: boolean;
+  /** Enable post-enrichment email verification */
+  enabled?: boolean;
+  /** Verification provider. Charges credits when use_system_credentials=True. */
+  provider?: "zerobounce" | "hunter" | "icypeas" | "leadmagic";
+  /** Use graph8-managed API keys (charges credits). False = use org's BYOK keys. */
+  use_system_credentials?: boolean;
+  /** Verification statuses to accept as valid. Typical: ['valid'] or ['valid','catch-all']. */
+  valid_statuses?: Array<string>;
+}
+
+export interface EnrichJobResponse {
+  completed?: number | null;
+  failed_enrichments?: number | null;
+  job_id: string;
+  provider_errors?: Array<Record<string, unknown>> | null;
+  results?: Array<Record<string, unknown>> | null;
+  status: string;
+  successful_enrichments?: number | null;
+  total?: number | null;
+  total_credits_used?: number | null;
+  warnings?: Array<string> | null;
+}
+
+/** Request to start an async waterfall enrichment job. */
+export interface EnrichRequest {
+  /** Contact IDs to enrich */
+  contact_ids: Array<number>;
+  /** Fields to enrich and provider order. Example: {"work_email": ["prospeo", "dropcontact"]} */
+  fields_config?: Record<string, Array<string>> | null;
+  /** List ID the contacts belong to */
+  list_id: number;
+}
+
+/**
+ * Fields to change on an enrichment configuration.
+ *
+ * A free-form update, matching the app: whatever keys are sent are written.
+ * `updated_by` is set from the calling key and cannot be supplied.
+ */
+export interface EnrichmentConfigUpdateRequest {
+  is_active?: boolean | null;
+  name?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * A collection result.
+ *
+ * `items` is ALWAYS present, so a caller can iterate without knowing whether
+ * the handler returned a bare list or a named key. When the handler used a
+ * named key that key is preserved beside `items` rather than renamed, because
+ * renaming it would make the API and the app disagree about the same data.
+ */
+export interface EnrichmentListPayload {
+  /** The collection, always present. */
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * One enrichment object, open-shaped.
+ *
+ * Open on purpose: a workbench column set is defined by the CUSTOMER at
+ * runtime, and the enrichment result shapes grow with every provider added.
+ * Pinning them would drop whatever a provider returned that this contract had
+ * not caught up on, which on an enrichment surface is the data the customer
+ * paid for.
+ */
+export type EnrichmentPayload = Record<string, unknown>;
+
+/** Price every visible qualification template against one list. Charges nothing. */
+export interface EstimateAllRequest {
+  list_id: number;
+}
+
+/** How one field is reconciled when the source and the record disagree. */
+export interface FieldPolicy {
+  empty_source?: "ignore" | "explicit_retraction";
+  mode?: "preserve" | "fill_missing" | "source_owned" | "replace";
+  preserve_manual_edits?: boolean;
+}
+
+/** A formula and the metadata that explains it. */
+export interface FormulaConfigDto {
+  ai_prompt?: string | null;
+  complexity?: string | null;
+  explanation?: string | null;
+  field_dependencies?: Array<string> | null;
+  formula: string;
+  output_type?: string | null;
+}
+
+/** Turn a sentence into a routing filter. */
+export interface GenerateFilterRequest {
+  prompt: string;
+  source_list_id: number;
+}
+
+/** Import search results into the destination list. */
+export interface ImportFindPeopleRequest {
+  /** Import results for these companies. OMIT to import ALL pending. */
+  company_ids?: Array<number> | null;
+  destination_list_id?: number | null;
+  /** Specific results. Overrides `company_ids` when given. */
+  result_ids?: Array<number> | null;
+}
+
+/** Create a new AI column as part of saving the pipeline. */
+export interface InlineAIConfig {
+  kind: "ai";
+  model?: string;
+  outputs: Array<InlineOutputField>;
+  prompt: string;
+  scope?: ("contact" | "company") | null;
+  usecase?: "create-modify-content" | "content-generation" | "web-research";
+}
+
+export interface InlineOutputField {
+  name: string;
+  type?: "Text" | "Number" | "Boolean";
+}
+
+/** Add a qualification column from a template. */
+export interface InlineQualificationConfig {
+  entity: "company" | "contact";
+  kind: "qualification";
+  template_id?: string | null;
+}
+
+/** Add a waterfall that fills an existing column. */
+export interface InlineWaterfallConfig {
+  kind: "waterfall";
+  target_column: string;
+  verify?: boolean;
+}
+
+/** Build a pipeline from a recipe in `GET /enrichment/lists/pipeline-templates`. */
+export interface InstantiatePipelineTemplateRequest {
+  qualification_template_id?: string | null;
+  template_key: string;
+}
+
+/** Why a job is being paused or cancelled. Recorded on the job. */
+export interface JobControlRequest {
+  reason?: string | null;
+}
+
+/** One step. Exactly one of `config_ref` or `inline_config`. */
+export interface ListPipelineStep {
+  /** An existing config's group or column id. */
+  config_ref?: string;
+  enabled?: boolean;
+  id: string;
+  inline_config?: (InlineAIConfig | InlineQualificationConfig | InlineWaterfallConfig) | null;
+  name?: string;
+  run_condition?: string | null;
+  skip_existing_values?: boolean;
+  skip_recently_enriched?: boolean;
+  type: "ai" | "waterfall";
+  ui_meta?: Record<string, unknown> | null;
+}
+
+/** Route records to different lists based on an AI output field. */
+export interface ListRoutingDto {
+  enabled?: boolean;
+  field_name?: string;
+  list_mappings?: Record<string, number>;
+}
+
+export interface LookupResponse {
+  confidence?: number;
+  data?: Record<string, unknown> | null;
+  found: boolean;
+}
+
+/** How enriched source data is reconciled onto the customer's records. */
+export interface MashupSyncPolicy {
+  audience_ids?: Array<string>;
+  batch_size?: number;
+  company_changes?: "review" | "verified";
+  default_field?: FieldPolicy;
+  /** Turning this on starts recurring reconciliation, which SPENDS enrichment credit. */
+  enabled?: boolean;
+  excluded_local_ids?: Array<string>;
+  fields?: Record<string, FieldPolicy>;
+  max_records_per_run?: number;
+  minimum_confidence?: number;
+  paused?: boolean;
+  resume_mode?: "latest" | "review";
+  schedule?: SyncSchedule;
+}
+
+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;
+}
+
+export interface PersonLookupRequest {
+  /** Company domain (requires first_name + last_name) */
+  company_domain?: string | null;
+  /** Work email address */
+  email?: string | null;
+  /** First name (requires last_name + company_domain) */
+  first_name?: string | null;
+  /** Last name (requires first_name + company_domain) */
+  last_name?: string | null;
+  /** LinkedIn profile URL */
+  linkedin_url?: string | null;
+}
+
+/** Count what a routing rule WOULD move, without moving anything. */
+export interface PreviewRoutingRequest {
+  conditions?: Array<ConditionDto>;
+  source_list_id: number;
+}
+
+/** Ask the model to write an enrichment prompt from a list's columns. */
+export interface PromptGeneratorRequest {
+  list_id: number;
+  task_description: string;
+}
+
+/**
+ * One enrichment provider in the catalog: its credential mode + credit cost.
+ *
+ * Lets a caller see which providers graph8 funds (usable with no setup, charges
+ * credits) vs which require the org's own API key (BYOK), before building a
+ * pipeline — the programmatic equivalent of the UI's provider picker.
+ */
+export interface ProviderCatalogEntry {
+  /** Action identifiers available for this provider. */
+  actions?: Array<string>;
+  /** True if the org has an active BYOK key configured for this provider. */
+  byok_configured: boolean;
+  /** Per-action credit cost when run on graph8 system credentials (action -> credits/row). */
+  credits_per_row?: Record<string, number>;
+  /** What credential_mode='auto' resolves to for this provider for this org right now. */
+  default_credential_source: "system" | "byok";
+  provider: string;
+  /** True if graph8 holds a system-managed key for this provider (usable without BYOK; charges credits). */
+  system_funded: boolean;
+}
+
+/**
+ * Catalog of enrichment providers: which are graph8-funded (system) by default
+ * vs require the org's own key (BYOK), plus the credit cost per action.
+ */
+export interface ProviderCatalogResponse {
+  count?: number;
+  providers?: Array<ProviderCatalogEntry>;
+}
+
+/**
+ * Per-step credential breakdown so callers can see, before running, which
+ * steps use graph8 system keys (charge credits) vs the org's own BYOK key,
+ * and whether the required credential is actually present.
+ */
+export interface ProviderStepDetail {
+  /** True if the step can actually run: system steps are always ready; BYOK steps are ready only when the org has an active key for that provider. */
+  credential_ready: boolean;
+  /** 'system' = graph8-funded; 'byok' = org's own key. */
+  credential_source: "system" | "byok";
+  /** True = uses graph8-managed system key (charges credits). False = uses org BYOK key. */
+  is_system_provider: boolean;
+  provider: string;
+}
+
+/** Read in-flight per-record enrichment progress. A read, not a run. */
+export interface RecordProgressRequest {
+  /** Records to report on. The app caps this at 500 and ignores the rest. */
+  record_ids?: Array<string>;
+}
+
+/** Show what syncing one record would change, without changing it. */
+export interface RecordSyncPreviewRequest {
+  event_id: string;
+  /** The record id. */
+  local_id: string;
+  /** Preview against this policy instead of the saved one. */
+  policy?: MashupSyncPolicy | null;
+}
+
+/** Request a sync run now. */
+export interface RecordSyncRunRequest {
+  /** The policy version you read. */
+  expected_version: number;
+}
+
+/** Rename the column an AI group writes into. Display name only. */
+export interface RenameAIColumnRequest {
+  column_id: string;
+  name: string;
+}
+
+/** Resolve one flagged record-sync change. */
+export interface ReviewRequest {
+  /** `retry` re-applies the change; `preserve` keeps the record as it is. */
+  action: "retry" | "preserve";
+  event_id: string;
+  expected_version: number;
+  /** The record, as an exact decimal string. */
+  local_id: string;
+  /** Always null on a review; the stored policy applies. */
+  policy?: null;
+}
+
+/**
+ * Run a saved AI enrichment config on specific records.
+ *
+ * The prompt, model, outputs, and column mapping live on the config
+ * referenced by `group_id`. We accept `record_ids` so callers can target
+ * exactly the contacts they want enriched.
+ */
+export interface RunAIEnrichRequest {
+  /** group_id of a saved AI enrichment config (starts with 'ai_enrich') */
+  group_id: string;
+  /** List ID the records belong to */
+  list_id: number;
+  /** Optional cap on records processed (defaults to len(record_ids)). */
+  max_records?: number | null;
+  /** Contact IDs to enrich */
+  record_ids: Array<number>;
+  /** Override the config's skip_existing_values setting. */
+  skip_existing_values?: boolean | null;
+}
+
+/** Which companies a find-people config runs over. */
+export interface RunFindPeopleRequest {
+  enrichment_mode: "first_10" | "all_rows" | "selected";
+  /** Required for `selected`. */
+  record_ids?: Array<number> | null;
+}
+
+/**
+ * Which records a formula column is computed for.
+ *
+ * With no ids and no `mode`, the formula runs over the list's records up to
+ * `max_records`. `mode: empty` fills only records whose value is blank.
+ */
+export interface RunFormulaRequest {
+  batch_size?: number;
+  context_record_ids?: Array<number> | null;
+  /** Validate only; write nothing. */
+  dry_run?: boolean;
+  max_records?: number | null;
+  mode?: ("selected" | "visible" | "empty") | null;
+  record_ids?: Array<number> | null;
+  visible_record_ids?: Array<number> | null;
+}
+
+/** Qualify a list against a template. */
+export interface RunQualificationRequest {
+  list_id: number;
+  /** Re-run records that already have a verdict. */
+  requalify?: boolean;
+  template_id: string;
+  usecase?: ("web-research" | "create-modify-content") | null;
+}
+
+/** Run a saved waterfall pipeline on specific records. */
+export interface RunWaterfallEnrichRequest {
+  /** column_id from a saved waterfall pipeline */
+  column_id: string;
+  /** List ID the records belong to */
+  list_id: number;
+  /** Contact IDs to enrich */
+  record_ids: Array<number>;
+  /** Override the pipeline's skip_existing_values setting. If None (default), the pipeline's saved setting is used. */
+  skip_existing_values?: boolean | null;
+}
+
+/** Save an AI enrichment group. Saving costs nothing; running it does. */
+export interface SaveAIConfigRequest {
+  config: AIEnrichmentConfigDto;
+  /** Always false. Saving never runs - the app refuses immediate execution so a save can never become an unpriced spend. */
+  run_immediately?: false;
+  target_records?: Array<string> | null;
+}
+
+/**
+ * Create a list pipeline.
+ *
+ * `enabled: true` ARMS it: an enabled pipeline runs its steps over the list,
+ * and every enrichment step charges.
+ */
+export interface SaveListPipelineRequest {
+  enabled?: boolean;
+  name: string;
+  steps: Array<ListPipelineStep>;
+}
+
+/** One people-search condition. */
+export interface SearchFilterDto {
+  field: string;
+  operator: string;
+  value?: Array<unknown>;
+}
+
+/** Import people directly, either a given set or everything an ICP query matches. */
+export interface SearchImportRequest {
+  /** Contacts to import directly. */
+  contacts?: Array<Record<string, unknown>> | null;
+  destination_list_id: number;
+  /** Import EVERYTHING these filters match, up to `max_result`. The unbounded form of this operation. */
+  icp_filters?: Array<Record<string, unknown>> | null;
+  max_employees_per_company?: number | null;
+  max_result?: number | null;
+  source_companies?: Array<SourceCompanyDto>;
+  source_list_id: number;
+}
+
+/**
+ * Turn a pipeline on or off.
+ *
+ * Explicit rather than a toggle, so a retried request cannot silently restart
+ * a pipeline a caller had just stopped.
+ */
+export interface SetPipelineEnabledRequest {
+  enabled: boolean;
+}
+
+/** A company the imported contacts are attributed back to. */
+export interface SourceCompanyDto {
+  company_domain?: string | null;
+  company_id: number;
+  company_name?: string | null;
+}
+
+/** When the reconciliation runs. */
+export interface SyncSchedule {
+  frequency?: "manual" | "hourly" | "daily" | "weekly";
+  time?: string;
+  timezone?: string;
+  weekdays?: Array<number>;
+}
+
+/** Replace an AI enrichment group's definition. */
+export interface UpdateAIConfigRequest {
+  config: AIEnrichmentConfigDto;
+}
+
+/** Edit an auto-enrichment configuration. */
+export interface UpdateAutoEnrichmentConfigRequest {
+  /** Enrich every newly inserted record automatically. Turning this on starts ONGOING credit spend with no further call. */
+  trigger_on_insert?: boolean | null;
+}
+
+/**
+ * Organisation-wide auto-enrichment for one record kind.
+ *
+ * `default_rule` decides who wins when enriched data disagrees with what is
+ * on the record: `sticky` keeps the first value, `user_wins` never overwrites
+ * a person's edit, `mashup_wins` lets enrichment overwrite.
+ */
+export interface UpdateAutoEnrichmentSettingsRequest {
+  default_rule?: "sticky" | "user_wins" | "mashup_wins";
+  enabled?: boolean;
+  per_field_overrides?: Record<string, "sticky" | "user_wins" | "mashup_wins">;
+}
+
+/** Hand-edit one enriched cell. No provider is called and nothing is charged. */
+export interface UpdateEnrichmentFieldRequest {
+  list_id?: number | null;
+  record_type?: "contact" | "company";
+  /** The new value. Null clears the cell. */
+  value: unknown;
+}
+
+/** Edit a people-search configuration. Omitted fields are unchanged. */
+export interface UpdateFindPeopleConfigRequest {
+  auto_import?: boolean | null;
+  column_mappings?: Array<ColumnMappingDto> | null;
+  company_identifier_column?: string | null;
+  destination_list_id?: number | null;
+  is_active?: boolean | null;
+  max_people_per_company?: number | null;
+  max_total_people?: number | null;
+  name?: string | null;
+  search_filters?: Array<SearchFilterDto> | null;
+  skip_across_companies?: boolean | null;
+  skip_existing_in_destination?: boolean | null;
+}
+
+/** Edit a formula column. Omitted fields are left alone. */
+export interface UpdateFormulaConfigRequest {
+  config?: FormulaConfigDto | null;
+  data_type?: string | null;
+  field_to_enrich?: string | null;
+  name?: string | null;
+}
+
+/** Replace a list pipeline's definition. `enabled` omitted keeps its state. */
+export interface UpdateListPipelineRequest {
+  enabled?: boolean | null;
+  name: string;
+  steps: Array<ListPipelineStep>;
+}
+
+/**
+ * Replace the record-sync policy.
+ *
+ * `expected_version` is the version the caller READ. A stale value is
+ * rejected rather than applied, so two editors cannot silently overwrite each
+ * other's policy - which on this object decides what gets overwritten on
+ * every record in the org.
+ */
+export interface UpdateMashupSyncPolicyRequest {
+  /** Version this edit was based on. */
+  expected_version: number;
+  policy: MashupSyncPolicy;
+}
+
+/** Edit a qualification template's wording. */
+export interface UpdateQualificationTemplateRequest {
+  description: string;
+  name: string;
+  prompt: string;
+}
+
+/** Replace a waterfall's definition. */
+export interface UpdateWaterfallConfigRequest {
+  config: WaterfallConfig;
+}
+
+/** Price an AI enrichment before running it. Charges nothing. */
+export interface ValidateCreditsRequest {
+  context_record_ids?: (Array<number | string>) | null;
+  /** Deprecated. Pricing is computed server-side and this is ignored. */
+  credits_per_record?: number | null;
+  /** 'first_10', 'all' or 'error_only'. */
+  enrichment_mode?: string | null;
+  filter_model?: Record<string, unknown> | null;
+  /** AI enrichment group id. */
+  group_id?: string | null;
+  list_id?: number | null;
+  max_records?: number | null;
+  /** 'bulk' or 'column'. */
+  mode?: string | null;
+  /** Direct record count. */
+  record_count?: number | null;
+  record_ids?: (Array<number | string>) | null;
+  sort_model?: Array<Record<string, string>> | null;
+  visible_record_ids?: (Array<number | string>) | null;
+}
+
+/** Price a waterfall enrichment before running it. Charges nothing. */
+export interface ValidateWaterfallCreditsRequest {
+  /** Waterfall enrichment column id. */
+  column_id: string;
+  context_record_ids?: (Array<number | string>) | null;
+  /** Deprecated. Pricing is computed server-side and this is ignored. */
+  credits_per_record?: number | null;
+  /** 'first_10', 'all' or 'error_only'. */
+  enrichment_mode?: string | null;
+  filter_model?: Record<string, unknown> | null;
+  list_id?: number | null;
+  max_records?: number | null;
+  /** 'bulk' or 'column'. */
+  mode?: string | null;
+  /** Direct record count. */
+  record_count?: number | null;
+  record_ids?: (Array<number | string>) | null;
+  sort_model?: Array<Record<string, string>> | null;
+  visible_record_ids?: (Array<number | string>) | null;
+}
+
+export interface VerifyEmailRequest {
+  /** Email address to verify */
+  email: string;
+}
+
+export type VerifyEmailResponse = Record<string, unknown>;
+
+/**
+ * A complete waterfall definition.
+ *
+ * `org_id` and `created_by` are accepted for shape parity with the app and
+ * IGNORED: the organisation always comes from the API key.
+ */
+export interface WaterfallConfig {
+  auto_update?: boolean;
+  column_id: string;
+  /** Ignored. */
+  created_by?: string | null;
+  data_type?: string;
+  email_verification?: EmailVerificationConfig | null;
+  field_to_enrich: string;
+  hide_provider_columns?: boolean;
+  id?: string | null;
+  is_existing_column?: boolean;
+  is_global?: boolean;
+  list_id?: number | null;
+  list_routing?: WaterfallListRouting | null;
+  name: string;
+  /** Run condition formula. */
+  only_run_if?: string | null;
+  /** Ignored: the key's organisation is used. */
+  org_id?: string | null;
+  output_successful_provider?: boolean;
+  skip_existing_values?: boolean;
+  skip_recently_enriched?: boolean;
+  steps: Array<WaterfallStep>;
+  target_column_name?: string | null;
+  /** Deprecated: use `email_verification`. */
+  validate_emails?: boolean;
+}
+
+/**
+ * One saved waterfall pipeline attached to (or global for) a list.
+ *
+ * `column_id` is the handle the worker uses to resolve config + store
+ * enrichment output. `providers` is a de-duplicated list of step providers
+ * so callers can see at a glance what a pipeline actually runs.
+ */
+export interface WaterfallConfigSummary {
+  column_id: string;
+  data_type?: string | null;
+  field_to_enrich?: string | null;
+  is_active?: boolean;
+  is_global?: boolean;
+  list_id?: number | null;
+  /** Providers in this pipeline whose step is BYOK but the org has no active key (these steps will be skipped at run time). Empty when everything is runnable. */
+  missing_credentials?: Array<string>;
+  name: string;
+  providers?: Array<string>;
+  /** Per-step credential breakdown (system vs BYOK + readiness) for this pipeline. */
+  providers_detail?: Array<ProviderStepDetail>;
+  step_count?: number;
+}
+
+/** Paginated (by list_id filter) collection of waterfall pipeline configs. */
+export interface WaterfallConfigsResponse {
+  configs?: Array<WaterfallConfigSummary>;
+  count?: number;
+  list_id?: number | null;
+}
+
+/** Route records into lists by their verification result. */
+export interface WaterfallListRouting {
+  copy_columns?: boolean;
+  enabled?: boolean;
+  field_name?: string;
+  /** Verification status -> list id. */
+  list_mappings?: Record<string, number>;
+  routing_columns?: Record<string, unknown> | null;
+}
+
+/** One provider attempt in a waterfall. */
+export interface WaterfallStep {
+  action: string;
+  action_display_name: string;
+  confidence_threshold?: number;
+  config?: Record<string, unknown>;
+  enabled?: boolean;
+  id: string;
+  input_mapping?: Record<string, string>;
+  /** Use graph8's provider credentials. Those calls are charged. */
+  is_system_provider?: boolean;
+  max_retries?: number;
+  order: number;
+  output_field?: string | null;
+  /** Deprecated. */
+  output_mapping?: Record<string, string> | null;
+  /** Provider name, from `GET /enrichment/providers`. */
+  provider: string;
+  stop_on_success?: boolean;
+}
+
+/**
+ * Single step in a caller-supplied waterfall sequence.
+ *
+ * Mirrors `WaterfallStepDto` in `enrichment/interfaces/fastapi/waterfall_dtos.py`.
+ * Persisted verbatim into `enrichment_configs.config.steps[]` so the CF
+ * worker can resolve provider, action and credentials the same way
+ * UI-saved pipelines do.
+ */
+export interface WaterfallStepInput {
+  /** Provider action: lookup_person, find_email, enrich_person, ... */
+  action: string;
+  /** Human-readable label shown in UI. Auto-titled from `action` if omitted. */
+  action_display_name?: string | null;
+  confidence_threshold?: number;
+  /** Provider-specific options (e.g. apollo `reveal_phone_numbers=true`). */
+  config?: Record<string, unknown>;
+  enabled?: boolean;
+  /** Step identifier. Auto-generated (`step_<provider>_<uuid8>`) if omitted. */
+  id?: string | null;
+  /** Maps provider input names to graph8 column identifiers (CONTACT_*). */
+  input_mapping?: Record<string, string>;
+  /** True = use graph8-managed credentials + charge credits. False = use org BYOK. */
+  is_system_provider?: boolean;
+  max_retries?: number;
+  /** 0-indexed execution order. */
+  order?: number;
+  /** Dotted path the worker writes into (e.g. 'contact.work_email'). */
+  output_field?: string | null;
+  /** Optional output field remap (deprecated — prefer `output_field`). */
+  output_mapping?: Record<string, string>;
+  /** Provider name: graph8, hunter, prospeo, dropcontact, apollo, ... */
+  provider: string;
+  stop_on_success?: boolean;
+}