@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/voice.d.ts

@@ -0,0 +1,4661 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.voice` (Voice): 187 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"attach_skills_to_agent_voice_agents__agent_id__skills_post">;
+ *
+ * Reference with examples: voice.md
+ */
+/* eslint-disable */
+
+/** `g8.api.voice.<member>` -> the operationId it calls. */
+export interface VoiceMembers {
+  attachSkillsToAgent: "attach_skills_to_agent_voice_agents__agent_id__skills_post";
+  batchEmailAgent: "batch_email_agent_voice_email_agent_batch_post";
+  bulkDeleteVideoRecordings: "bulk_delete_video_recordings_voice_video_recordings_delete";
+  calculateWorksheet: "calculate_worksheet_voice_worksheets_calculate_post";
+  checkCollectionFileExists: "check_collection_file_exists_voice_collections__collection_id__files_exists_get";
+  claimInboundCall: "claim_inbound_call_voice_inbound_calls__room_name__claim_post";
+  classifyTopics: "classify_topics_voice_topics_classify_post";
+  clearCollectionVectors: "clear_collection_vectors_voice_collections__collection_id__vectors_delete";
+  cloneAgent: "clone_agent_voice_agents_clone_post";
+  cloneVoice: "clone_voice_voice_voice_library_voices_post";
+  composeEmail: "compose_email_voice_email_agent_compose_post";
+  createAgentTestCase: "create_agent_test_case_voice_agents__agent_id__test_cases_post";
+  createCollection: "create_collection_voice_collections_post";
+  createCollectionFolder: "create_collection_folder_voice_collections__collection_id__folders_post";
+  createCompanyKnowledge: "create_company_knowledge_voice_company_knowledge_post";
+  createDialerSession: "create_dialer_session_voice_dialer_sessions_post";
+  createInboundRoute: "create_inbound_route_voice_inbound_routing_rules_post";
+  createMcpServer: "create_mcp_server_voice_mcp_servers_post";
+  createOnboardingThread: "create_onboarding_thread_voice_campaigns_onboarding_threads_post";
+  createPhoneDirectoryEntry: "create_phone_directory_entry_voice_phone_directory_post";
+  createScrapeSource: "create_scrape_source_voice_collections__collection_id__scrape_sources_post";
+  createTwin: "create_twin_voice_twins_post";
+  createVoiceAgent: "create_voice_agent_voice_agents_post";
+  createVoiceDisposition: "create_voice_disposition_voice_dispositions_post";
+  declineDialerInboundCall: "decline_dialer_inbound_call_voice_inbound_calls_dialer__call_id__decline_post";
+  declineInboundCall: "decline_inbound_call_voice_inbound_calls_decline_post";
+  deleteAgentDocument: "delete_agent_document_voice_agent_documents__document_id__delete";
+  deleteAgentTestCase: "delete_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__delete";
+  deleteAllCollectionFiles: "delete_all_collection_files_voice_collections__collection_id__files_all_delete";
+  deleteBusinessHours: "delete_business_hours_voice_inbound_routing_business_hours_delete";
+  deleteChatAgentConversation: "delete_chat_agent_conversation_voice_chat_agent_conversations__chat_id__delete";
+  deleteCollection: "delete_collection_voice_collections__collection_id__delete";
+  deleteCollectionFile: "delete_collection_file_voice_collections__collection_id__files_delete";
+  deleteCollectionFolder: "delete_collection_folder_voice_collections__collection_id__folders_delete";
+  deleteInboundRoute: "delete_inbound_route_voice_inbound_routing_rules__route_id__delete";
+  deleteJob: "delete_job_voice_jobs__job_id__delete";
+  deleteKnowledgeBaseFile: "delete_knowledge_base_file_voice_knowledge_base_files_delete";
+  deleteMcpServer: "delete_mcp_server_voice_mcp_servers__mcp_server_id__delete";
+  deleteOnboardingThread: "delete_onboarding_thread_voice_campaigns_onboarding_threads_delete";
+  deletePhoneDirectoryEntry: "delete_phone_directory_entry_voice_phone_directory__entry_id__delete";
+  deleteScrapeSource: "delete_scrape_source_voice_collections__collection_id__scrape_sources__source_id__delete";
+  deleteTwin: "delete_twin_voice_twins__agent_id__delete";
+  deleteVideoRecording: "delete_video_recording_voice_video_recordings__video_id__delete";
+  deleteVoiceAgent: "delete_voice_agent_voice_agents__agent_id__delete";
+  detachSkillFromAgent: "detach_skill_from_agent_voice_agents__agent_id__skills__action_id__delete";
+  downloadCallRecording: "download_call_recording_voice_calls__call_id__recording_get";
+  downloadHistoricalCallRecording: "download_historical_call_recording_voice_calls__call_id__historical_recording_get";
+  downloadKnowledgeBaseFile: "download_knowledge_base_file_voice_knowledge_base_files_download_get";
+  downloadTwinFile: "download_twin_file_voice_twins_files_download_get";
+  draftEmailReply: "draft_email_reply_voice_email_agent_draft_reply_post";
+  enhanceCampaignEmail: "enhance_campaign_email_voice_campaigns_email_enhancements_post";
+  ensureReceptionistAgent: "ensure_receptionist_agent_voice_agents_receptionist_post";
+  estimateCampaignEmail: "estimate_campaign_email_voice_campaigns_email_estimate_post";
+  exportDialerReport: "export_dialer_report_dialer_parallel_calls_analytics_dialer_report_export_get";
+  extractTwinLinkedinProfile: "extract_twin_linkedin_profile_voice_twins_extract_linkedin_post";
+  generateCallScript: "generate_call_script_voice_call_scripts_generate_post";
+  generateCampaignCallScript: "generate_campaign_call_script_voice_campaigns_call_scripts_post";
+  generateCampaignCallScripts: "generate_campaign_call_scripts_voice_campaigns_call_scripts_get";
+  generateCampaignEmail: "generate_campaign_email_voice_campaigns_emails_post";
+  generateCampaignEmails: "generate_campaign_emails_voice_campaigns_email_templates_get";
+  generateCampaignTemplate: "generate_campaign_template_voice_campaigns_templates_get";
+  generateEmailSpintax: "generate_email_spintax_voice_campaigns_email_spintax_post";
+  generateIcpQueries: "generate_icp_queries_voice_icp_queries_post";
+  generateLinkedinMessage: "generate_linkedin_message_voice_campaigns_linkedin_messages_post";
+  generatePersonalisedVoicemail: "generate_personalised_voicemail_voice_campaigns_voicemails_post";
+  getAgentActivity: "get_agent_activity_voice_agents__agent_id__activity_get";
+  getAgentDefaults: "get_agent_defaults_voice_agents_defaults_get";
+  getAgentGlobalSettings: "get_agent_global_settings_voice_agents_global_settings_get";
+  getAgentSkillStats: "get_agent_skill_stats_voice_agents__agent_id__skill_stats_get";
+  getAgentTestSuiteStatus: "get_agent_test_suite_status_voice_agents__agent_id__test_suite_status_get";
+  getBusinessHours: "get_business_hours_voice_inbound_routing_business_hours_get";
+  getCachedMcpTools: "get_cached_mcp_tools_voice_mcp_servers__mcp_server_id__tools_cached_get";
+  getCallArtifacts: "get_call_artifacts_voice_calls__call_id__artifacts_get";
+  getCallGrading: "get_call_grading_voice_dialer_calls__room_name__grading_get";
+  getCallTranscript: "get_call_transcript_voice_dialer_calls__room_name__transcript_get";
+  getChatAgentHistory: "get_chat_agent_history_voice_chat_agent_history_post";
+  getCollection: "get_collection_voice_collections__collection_id__get";
+  getCollectionFileDownloadUrl: "get_collection_file_download_url_voice_collections__collection_id__files_download_url_get";
+  getCollectionStats: "get_collection_stats_voice_collections__collection_id__stats_get";
+  getCollectionVectorStatus: "get_collection_vector_status_voice_collections__collection_id__vector_status_get";
+  getCompanyKnowledge: "get_company_knowledge_voice_company_knowledge_get";
+  getDialerSession: "get_dialer_session_dialer_sessions__session_id__get";
+  getDialerSettings: "get_dialer_settings_dialer_settings__user_email__get";
+  getDialerStats: "get_dialer_stats_voice_dialer_stats_get";
+  getDispositionUsage: "get_disposition_usage_dialer_dispositions__disposition_id__usage_get";
+  getFormattedCompanyKnowledge: "get_formatted_company_knowledge_voice_company_knowledge_formatted_get";
+  getJob: "get_job_voice_jobs__job_id__get";
+  getOnboardingThread: "get_onboarding_thread_voice_campaigns_onboarding_threads__thread_id__get";
+  getPastConversation: "get_past_conversation_voice_campaigns_past_conversation_get";
+  getTwin: "get_twin_voice_twins__agent_id__get";
+  getVideoRecording: "get_video_recording_voice_video_recordings__video_id__get";
+  getVideoRecordingUrl: "get_video_recording_url_voice_video_recordings__video_id__url_get";
+  getVoiceAgent: "get_voice_agent_voice_agents__agent_id__get";
+  listAgentDocuments: "list_agent_documents_voice_agents__agent_id__documents_get";
+  listAgentPhoneNumbers: "list_agent_phone_numbers_voice_agent_phone_numbers_get";
+  listAgentSkills: "list_agent_skills_voice_agents__agent_id__skills_get";
+  listAgentTemplates: "list_agent_templates_voice_agent_templates_get";
+  listAgentTestCases: "list_agent_test_cases_voice_agents__agent_id__test_cases_get";
+  listAgentTestRuns: "list_agent_test_runs_voice_agents__agent_id__test_runs_get";
+  listAllCollectionFiles: "list_all_collection_files_voice_collections_files_get";
+  listCallResultCampaigns: "list_call_result_campaigns_voice_call_results_campaigns_get";
+  listCallsForContact: "list_calls_for_contact_voice_dialer_calls_get";
+  listCampaignEmailModels: "list_campaign_email_models_voice_campaigns_email_models_get";
+  listChatAgentConversations: "list_chat_agent_conversations_voice_chat_agent_conversations_post";
+  listClonedVoices: "list_cloned_voices_voice_voice_library_voices_get";
+  listCollections: "list_collections_voice_collections_get";
+  listDepartmentColleagues: "list_department_colleagues_voice_phone_directory_departments__department__get";
+  listDialerAgents: "list_dialer_agents_voice_dialer_agents_get";
+  listDialerNumbers: "list_dialer_numbers_voice_dialer_numbers_get";
+  listDialerSessions: "list_dialer_sessions_voice_dialer_sessions_get";
+  listInboundCallResults: "list_inbound_call_results_voice_call_results_inbound_get";
+  listInboundRoutes: "list_inbound_routes_voice_inbound_routing_rules_get";
+  listKnowledgeBaseFiles: "list_knowledge_base_files_voice_knowledge_base_files_get";
+  listMcpServerTools: "list_mcp_server_tools_voice_mcp_servers__mcp_server_id__tools_get";
+  listMissedCallbacks: "list_missed_callbacks_voice_dialer_missed_callbacks_get";
+  listOnboardingThreads: "list_onboarding_threads_voice_campaigns_onboarding_threads_get";
+  listPastConversations: "list_past_conversations_voice_campaigns_past_conversations_get";
+  listPendingInboundCalls: "list_pending_inbound_calls_voice_inbound_calls_pending_get";
+  listPhoneDirectory: "list_phone_directory_voice_phone_directory_get";
+  listPresetVoices: "list_preset_voices_voice_voice_library_presets_get";
+  listReachableColleagues: "list_reachable_colleagues_voice_phone_directory_reachable_get";
+  listScrapeSources: "list_scrape_sources_voice_collections__collection_id__scrape_sources_get";
+  listTwins: "list_twins_voice_twins_get";
+  listVideoRecordings: "list_video_recordings_voice_video_recordings_get";
+  listVoiceAgents: "list_voice_agents_voice_agents_get";
+  listVoiceDispositions: "list_voice_dispositions_voice_dispositions_get";
+  listVoicemails: "list_voicemails_voice_voicemails_get";
+  lookupSessionCalls: "lookup_session_calls_dialer_parallel_calls_sessions__session_id__calls_post";
+  markAllVoicemailsRead: "mark_all_voicemails_read_voice_voicemails_read_all_patch";
+  markVoicemailRead: "mark_voicemail_read_voice_voicemails__voicemail_id__read_patch";
+  pasteTextIntoCollection: "paste_text_into_collection_voice_collections__collection_id__files_paste_text_post";
+  pauseDialerSession: "pause_dialer_session_dialer_sessions__session_id__pause_post";
+  reindexCollection: "reindex_collection_voice_collections__collection_id__reindex_post";
+  renameChatAgentConversation: "rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put";
+  renameCollectionFile: "rename_collection_file_voice_collections__collection_id__files_rename_put";
+  renameKnowledgeBaseFile: "rename_knowledge_base_file_voice_knowledge_base_files_rename_put";
+  researchBusinessData: "research_business_data_voice_research_business_data_get";
+  researchCompany: "research_company_voice_research_company_post";
+  researchCompetitors: "research_competitors_voice_research_competitors_get";
+  researchFaq: "research_faq_voice_research_faq_get";
+  researchKeywords: "research_keywords_voice_research_keywords_get";
+  researchOrgChart: "research_org_chart_voice_research_org_chart_post";
+  researchProspectCompany: "research_prospect_company_voice_research_prospect_company_get";
+  researchProspectData: "research_prospect_data_voice_research_prospect_data_post";
+  researchProspectProfile: "research_prospect_profile_voice_research_prospect_profile_post";
+  resumeDialerSession: "resume_dialer_session_voice_dialer_sessions__session_id__resume_post";
+  runAgentTest: "run_agent_test_voice_agents__agent_id__test_post";
+  runAllAgentTests: "run_all_agent_tests_voice_agents__agent_id__test_run_all_post";
+  runOnboardingThreadAction: "run_onboarding_thread_action_voice_campaigns_onboarding_threads_actions_post";
+  runScrapeSource: "run_scrape_source_voice_collections__collection_id__scrape_sources__source_id__run_post";
+  saveAgentAsTemplate: "save_agent_as_template_voice_agents__agent_id__save_as_template_post";
+  searchAgentDocuments: "search_agent_documents_voice_agents__agent_id__documents_search_post";
+  searchCallResults: "search_call_results_voice_call_results_search_post";
+  searchChats: "search_chats_voice_chats_search_post";
+  searchCollections: "search_collections_voice_collections_search_post";
+  sendChatAgentMessage: "send_chat_agent_message_voice_chat_agent_messages_post";
+  sendOnboardingMessage: "send_onboarding_message_voice_campaigns_onboarding_messages_post";
+  sendReceptionistMessage: "send_receptionist_message_voice_receptionist_messages_post";
+  setAgentGlobalSettings: "set_agent_global_settings_voice_agents_global_settings_post";
+  setOnboardingVoice: "set_onboarding_voice_voice_voice_library_onboarding_voice_post";
+  startVoiceCall: "start_voice_call_voice_calls_post";
+  stopDialerSession: "stop_dialer_session_dialer_sessions__session_id__stop_post";
+  storeCampaignMemory: "store_campaign_memory_voice_campaigns_memory_post";
+  syncCollection: "sync_collection_voice_collections__collection_id__sync_post";
+  testMcpServer: "test_mcp_server_voice_mcp_servers__mcp_server_id__test_post";
+  toggleReceptionistAgent: "toggle_receptionist_agent_voice_agents_receptionist_patch";
+  transcribeCallFlowExample: "transcribe_call_flow_example_voice_call_flow_examples_transcribe_post";
+  transferChatAgentConversation: "transfer_chat_agent_conversation_voice_chat_agent_conversations__chat_id__transfer_to_human_post";
+  updateAgentMemory: "update_agent_memory_voice_agents__agent_id__memory_post";
+  updateAgentTestCase: "update_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__put";
+  updateCollection: "update_collection_voice_collections__collection_id__put";
+  updateCompanyKnowledge: "update_company_knowledge_voice_company_knowledge_put";
+  updateDialerSessionStatus: "update_dialer_session_status_voice_dialer_sessions__session_id__status_patch";
+  updateDialerSettings: "update_dialer_settings_dialer_settings_put";
+  updateInboundRoute: "update_inbound_route_voice_inbound_routing_rules__route_id__patch";
+  updateMcpServer: "update_mcp_server_voice_mcp_servers__mcp_server_id__put";
+  updatePhoneDirectoryEntry: "update_phone_directory_entry_voice_phone_directory__entry_id__put";
+  updateScrapeSource: "update_scrape_source_voice_collections__collection_id__scrape_sources__source_id__patch";
+  updateTwin: "update_twin_voice_twins__agent_id__put";
+  updateVoiceAgent: "update_voice_agent_voice_agents__agent_id__put";
+  updateVoiceDisposition: "update_voice_disposition_voice_dispositions__disposition_id__patch";
+  uploadAgentDocuments: "upload_agent_documents_voice_agents__agent_id__documents_upload_post";
+  uploadCollectionFile: "upload_collection_file_voice_collections__collection_id__files_upload_post";
+  uploadCollectionFiles: "upload_collection_files_voice_collections__collection_id__files_upload_multiple_post";
+  uploadKnowledgeBaseFile: "upload_knowledge_base_file_voice_knowledge_base_files_upload_post";
+  uploadVideoRecording: "upload_video_recording_voice_video_recordings_upload_post";
+  upsertBusinessHours: "upsert_business_hours_voice_inbound_routing_business_hours_put";
+}
+
+/** Input and output of every `g8.api.voice` operation, keyed by operationId. */
+export interface VoiceOperations {
+  /**
+   * POST /voice/agents/{agent_id}/skills
+   * Give an agent skills it can use
+   * tier: write · scope: voice:write
+   */
+  attach_skills_to_agent_voice_agents__agent_id__skills_post: {
+    input: {
+    path: {
+      /** The agent to equip. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_attach_skills_to_agent_voice_agents__agent_id__skills_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/email-agent/batch
+   * Draft many emails in one call
+   * tier: billable · scope: voice:run
+   */
+  batch_email_agent_voice_email_agent_batch_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BatchEmailProcessing;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/video-recordings
+   * Delete every recording for one subject
+   * tier: destructive · scope: voice:delete
+   */
+  bulk_delete_video_recordings_voice_video_recordings_delete: {
+    input: {
+    query: {
+      /** Whose recordings to delete. REQUIRED - there is no org-wide delete by omission. */
+      user_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/worksheets/calculate
+   * Fill worksheet cells with AI answers
+   * tier: billable · scope: voice:run
+   */
+  calculate_worksheet_voice_worksheets_calculate_post: {
+    input: {
+    query?: {
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}/files/exists
+   * Check whether a file is already in a collection
+   * tier: read · scope: voice:read
+   */
+  check_collection_file_exists_voice_collections__collection_id__files_exists_get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query: {
+      /** File name to look for. */
+      filename: string;
+      /** Folder inside the collection. */
+      folder_path?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/inbound-calls/{room_name}/claim
+   * Claim a ringing inbound call for one rep
+   * tier: external · scope: voice:run
+   */
+  claim_inbound_call_voice_inbound_calls__room_name__claim_post: {
+    input: {
+    path: {
+      /** The ringing call's room name. */
+      room_name: string;
+    };
+    query: {
+      /** The rep taking it. */
+      sdr_email: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/topics/classify
+   * Classify URLs into intent topics
+   * tier: billable · scope: voice:run
+   */
+  classify_topics_voice_topics_classify_post: {
+    input: {
+    query?: {
+      /** Defaults TRUE here, matching voice: a batch of URLs is slow enough that a synchronous call usually times out. Poll `GET /voice/jobs/{job_id}`. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}/vectors
+   * Clear a collection's vectors, keeping the files
+   * tier: destructive · scope: voice:delete
+   */
+  clear_collection_vectors_voice_collections__collection_id__vectors_delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/clone
+   * Clone an agent, or instantiate one from a template
+   * tier: write · scope: voice:write
+   */
+  clone_agent_voice_agents_clone_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_clone_agent_voice_agents_clone_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/voice-library/voices
+   * Clone a voice from a short audio sample
+   * tier: billable · scope: voice:run
+   */
+  clone_voice_voice_voice_library_voices_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/email-agent/compose
+   * Compose an email with the email agent
+   * tier: billable · scope: voice:run
+   */
+  compose_email_voice_email_agent_compose_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/test-cases
+   * Save an evaluation case for an agent
+   * tier: write · scope: voice:write
+   */
+  create_agent_test_case_voice_agents__agent_id__test_cases_post: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentTestCaseCreate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections
+   * Create a knowledge collection
+   * tier: write · scope: voice:write
+   */
+  create_collection_voice_collections_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CollectionCreateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/folders
+   * Create a folder in a collection
+   * tier: write · scope: voice:write
+   */
+  create_collection_folder_voice_collections__collection_id__folders_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CollectionFolder;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/company-knowledge
+   * Create the organisation's company knowledge
+   * tier: write · scope: voice:write
+   */
+  create_company_knowledge_voice_company_knowledge_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/dialer/sessions
+   * Create a parallel-dialer session in PAUSED state
+   * tier: external · scope: voice:run
+   */
+  create_dialer_session_voice_dialer_sessions_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DialerSessionCreateRequest;
+  };
+    output: ApiResponse_DialerSessionCreateResponse_;
+  };
+  /**
+   * POST /voice/inbound-routing/rules
+   * Create an inbound routing rule
+   * tier: write · scope: voice:write
+   */
+  create_inbound_route_voice_inbound_routing_rules_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: InboundRouteCreateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/mcp-servers
+   * Connect an MCP server
+   * tier: write · scope: voice:write
+   */
+  create_mcp_server_voice_mcp_servers_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: McpServerCreateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/onboarding/threads
+   * Start an onboarding conversation thread
+   * tier: write · scope: voice:write
+   */
+  create_onboarding_thread_voice_campaigns_onboarding_threads_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/phone-directory
+   * Add a colleague to the directory
+   * tier: write · scope: voice:write
+   */
+  create_phone_directory_entry_voice_phone_directory_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PhoneDirectoryEntryCreate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/scrape-sources
+   * Attach a web source and crawl it now
+   * tier: billable · scope: voice:run
+   */
+  create_scrape_source_voice_collections__collection_id__scrape_sources_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ScrapeSourceCreateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/twins
+   * Create a twin
+   * tier: billable · scope: voice:run
+   */
+  create_twin_voice_twins_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents
+   * Create a voice agent or twin
+   * tier: write · scope: voice:write
+   */
+  create_voice_agent_voice_agents_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceAgentCreateRequest;
+  };
+    output: ApiResponse_VoiceAgentResponse_;
+  };
+  /**
+   * POST /voice/dispositions
+   * Create a custom call disposition
+   * tier: external · scope: voice:run
+   */
+  create_voice_disposition_voice_dispositions_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceCustomDispositionCreateRequest;
+  };
+    output: ApiResponse_VoiceCustomDispositionItem_;
+  };
+  /**
+   * POST /voice/inbound-calls/dialer/{call_id}/decline
+   * Decline an inbound call arriving during a dialer session
+   * tier: external · scope: voice:run
+   */
+  decline_dialer_inbound_call_voice_inbound_calls_dialer__call_id__decline_post: {
+    input: {
+    path: {
+      /** Dialer call id. */
+      call_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/inbound-calls/decline
+   * Decline or hang up a ringing inbound call
+   * tier: external · scope: voice:run
+   */
+  decline_inbound_call_voice_inbound_calls_decline_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_decline_inbound_call_voice_inbound_calls_decline_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/agent-documents/{document_id}
+   * Delete a document from an agent's own store
+   * tier: destructive · scope: voice:delete
+   */
+  delete_agent_document_voice_agent_documents__document_id__delete: {
+    input: {
+    path: {
+      /** Document id. */
+      document_id: number;
+    };
+    query: {
+      /** The agent the document belongs to. Required: document ids are scoped per agent. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/agents/{agent_id}/test-cases/{test_case_id}
+   * Delete a saved case
+   * tier: destructive · scope: voice:delete
+   */
+  delete_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__delete: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+      /** Saved test case id. */
+      test_case_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}/files/all
+   * Delete every file in a collection
+   * tier: destructive · scope: voice:delete
+   */
+  delete_all_collection_files_voice_collections__collection_id__files_all_delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/inbound-routing/business-hours
+   * Remove the business-hours schedule for a number
+   * tier: destructive · scope: voice:delete
+   */
+  delete_business_hours_voice_inbound_routing_business_hours_delete: {
+    input: {
+    query: {
+      /** The number to clear. */
+      phone_number: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/chat-agent/conversations/{chat_id}
+   * Delete a chat agent conversation
+   * tier: destructive · scope: voice:delete
+   */
+  delete_chat_agent_conversation_voice_chat_agent_conversations__chat_id__delete: {
+    input: {
+    path: {
+      /** Conversation id. */
+      chat_id: string;
+    };
+    query: {
+      /** The agent that owns it. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}
+   * Delete a collection and everything in it
+   * tier: destructive · scope: voice:delete
+   */
+  delete_collection_voice_collections__collection_id__delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}/files
+   * Delete one file from a collection
+   * tier: destructive · scope: voice:delete
+   */
+  delete_collection_file_voice_collections__collection_id__files_delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query: {
+      /** The file to remove. REQUIRED - there is no 'delete everything' by omission. */
+      filename: string;
+      /** Folder inside the collection. */
+      folder_path?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}/folders
+   * Delete a folder and everything in it
+   * tier: destructive · scope: voice:delete
+   */
+  delete_collection_folder_voice_collections__collection_id__folders_delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query: {
+      /** The folder; subfolders go too. */
+      folder_path: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/inbound-routing/rules/{route_id}
+   * Delete an inbound routing rule
+   * tier: destructive · scope: voice:delete
+   */
+  delete_inbound_route_voice_inbound_routing_rules__route_id__delete: {
+    input: {
+    path: {
+      /** Rule id. */
+      route_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/jobs/{job_id}
+   * Cancel an async job
+   * tier: destructive · scope: voice:delete
+   */
+  delete_job_voice_jobs__job_id__delete: {
+    input: {
+    path: {
+      /** Job id. */
+      job_id: string;
+    };
+    query?: {
+      /** Which queue the job was placed on. */
+      queue?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/knowledge-base/files
+   * Delete a knowledge-base file
+   * tier: destructive · scope: voice:delete
+   */
+  delete_knowledge_base_file_voice_knowledge_base_files_delete: {
+    input: {
+    query: {
+      /** The file to remove. */
+      filename: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/mcp-servers/{mcp_server_id}
+   * Disconnect an MCP server
+   * tier: destructive · scope: voice:delete
+   */
+  delete_mcp_server_voice_mcp_servers__mcp_server_id__delete: {
+    input: {
+    path: {
+      /** MCP server id. */
+      mcp_server_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/campaigns/onboarding/threads
+   * Delete an onboarding thread
+   * tier: destructive · scope: voice:delete
+   */
+  delete_onboarding_thread_voice_campaigns_onboarding_threads_delete: {
+    input: {
+    query: {
+      /** The thread to delete. */
+      thread_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/phone-directory/{entry_id}
+   * Remove a directory entry
+   * tier: destructive · scope: voice:delete
+   */
+  delete_phone_directory_entry_voice_phone_directory__entry_id__delete: {
+    input: {
+    path: {
+      /** Directory entry id. */
+      entry_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/collections/{collection_id}/scrape-sources/{source_id}
+   * Remove a web source and the file it maintained
+   * tier: destructive · scope: voice:delete
+   */
+  delete_scrape_source_voice_collections__collection_id__scrape_sources__source_id__delete: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+      /** Scrape source id. */
+      source_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/twins/{agent_id}
+   * Delete a digital twin
+   * tier: destructive · scope: voice:delete
+   */
+  delete_twin_voice_twins__agent_id__delete: {
+    input: {
+    path: {
+      /** Twin id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/video-recordings/{video_id}
+   * Delete one video recording
+   * tier: destructive · scope: voice:delete
+   */
+  delete_video_recording_voice_video_recordings__video_id__delete: {
+    input: {
+    path: {
+      /** Recording id. */
+      video_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /voice/agents/{agent_id}
+   * Delete a voice agent or twin
+   * tier: destructive · scope: voice:write
+   */
+  delete_voice_agent_voice_agents__agent_id__delete: {
+    input: {
+    path: {
+      /** Agent UUID. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceAgentResponse_;
+  };
+  /**
+   * DELETE /voice/agents/{agent_id}/skills/{action_id}
+   * Take a skill away from an agent
+   * tier: destructive · scope: voice:delete
+   */
+  detach_skill_from_agent_voice_agents__agent_id__skills__action_id__delete: {
+    input: {
+    path: {
+      /** The agent. */
+      agent_id: string;
+      /** The skill to remove. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/calls/{call_id}/recording
+   * Stream a call's recording
+   * tier: read · scope: voice:read
+   */
+  download_call_recording_voice_calls__call_id__recording_get: {
+    input: {
+    path: {
+      /** Call id. */
+      call_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * GET /voice/calls/{call_id}/historical-recording
+   * Recover an old recording by its activity
+   * tier: read · scope: voice:read
+   */
+  download_historical_call_recording_voice_calls__call_id__historical_recording_get: {
+    input: {
+    path: {
+      /** Call id. */
+      call_id: string;
+    };
+    query: {
+      /** The activity that proves the recording belongs to this call. */
+      activity_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * GET /voice/knowledge-base/files/download
+   * Download a knowledge-base file
+   * tier: read · scope: voice:read
+   */
+  download_knowledge_base_file_voice_knowledge_base_files_download_get: {
+    input: {
+    query: {
+      /** The stored name, as listed. */
+      filename: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * GET /voice/twins/files/download
+   * Download a twin's stored file
+   * tier: read · scope: voice:read
+   */
+  download_twin_file_voice_twins_files_download_get: {
+    input: {
+    query: {
+      /** The stored key, as returned on the twin. */
+      s3_key: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * POST /voice/email-agent/draft-reply
+   * Draft a reply to an email
+   * tier: billable · scope: voice:run
+   */
+  draft_email_reply_voice_email_agent_draft_reply_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/email-enhancements
+   * Rewrite a generated email against an instruction
+   * tier: billable · scope: voice:run
+   */
+  enhance_campaign_email_voice_campaigns_email_enhancements_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/receptionist
+   * Get the org's receptionist, creating it if absent
+   * tier: write · scope: voice:write
+   */
+  ensure_receptionist_agent_voice_agents_receptionist_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/email-estimate
+   * Estimate what generating an email would cost
+   * tier: read · scope: voice:read
+   */
+  estimate_campaign_email_voice_campaigns_email_estimate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /dialer/parallel-calls/analytics/dialer-report/export
+   * Download the dialer report as a spreadsheet
+   * tier: read · scope: voice:read
+   */
+  export_dialer_report_dialer_parallel_calls_analytics_dialer_report_export_get: {
+    input: {
+    query?: {
+      /** One session only. */
+      session_id?: string | null;
+      /** One rep only. */
+      user_email?: string | null;
+      /** YYYY-MM-DD. */
+      date_from?: string | null;
+      /** YYYY-MM-DD. */
+      date_to?: string | null;
+      /** Per-day rows, or one summary. */
+      aggregation?: "daily" | "total";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: void;
+  };
+  /**
+   * POST /voice/twins/extract-linkedin
+   * Extract a LinkedIn profile to seed a twin
+   * tier: billable · scope: voice:run
+   */
+  extract_twin_linkedin_profile_voice_twins_extract_linkedin_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TwinLinkedInExtract;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/call-scripts/generate
+   * Generate a call script for one contact
+   * tier: billable · scope: voice:run
+   */
+  generate_call_script_voice_call_scripts_generate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CallScriptGenerate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/call-scripts
+   * Generate one personalised call script
+   * tier: billable · scope: voice:run
+   */
+  generate_campaign_call_script_voice_campaigns_call_scripts_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/campaigns/call-scripts
+   * Generate campaign call scripts
+   * tier: billable · scope: voice:run
+   */
+  generate_campaign_call_scripts_voice_campaigns_call_scripts_get: {
+    input: {
+    query?: {
+      /** Whose voice to write in. */
+      agent_name?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/emails
+   * Generate one personalised email
+   * tier: billable · scope: voice:run
+   */
+  generate_campaign_email_voice_campaigns_emails_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/campaigns/email-templates
+   * Generate campaign email templates
+   * tier: billable · scope: voice:run
+   */
+  generate_campaign_emails_voice_campaigns_email_templates_get: {
+    input: {
+    query?: {
+      /** Whose voice to write in. */
+      agent_name?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/campaigns/templates
+   * Generate a campaign template for a company
+   * tier: billable · scope: voice:run
+   */
+  generate_campaign_template_voice_campaigns_templates_get: {
+    input: {
+    query: {
+      /** The company website to work from. */
+      customer_url: string;
+      /** Which campaign shape to build. */
+      type_campaign?: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/email-spintax
+   * Turn an email into spintax
+   * tier: billable · scope: voice:run
+   */
+  generate_email_spintax_voice_campaigns_email_spintax_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/icp/queries
+   * Generate ICP and TAM query definitions from a website
+   * tier: billable · scope: voice:run
+   */
+  generate_icp_queries_voice_icp_queries_post: {
+    input: {
+    query: {
+      /** The company to build an ICP for. */
+      customer_url: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+      /** True stores the generated ICP against the org. False returns it only. */
+      persist?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/linkedin-messages
+   * Generate a LinkedIn message
+   * tier: billable · scope: voice:run
+   */
+  generate_linkedin_message_voice_campaigns_linkedin_messages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/voicemails
+   * Generate a personalised voicemail script
+   * tier: billable · scope: voice:run
+   */
+  generate_personalised_voicemail_voice_campaigns_voicemails_post: {
+    input: {
+    query?: {
+      /** Which campaign shape to write for. */
+      campaign_type?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/activity
+   * An agent's activity feed
+   * tier: read · scope: voice:read
+   */
+  get_agent_activity_voice_agents__agent_id__activity_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    query?: {
+      /** Maximum rows per activity type. */
+      limit?: number;
+      /** Look-back window in days. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/defaults
+   * The organisation's default agent profile
+   * tier: read · scope: voice:read
+   */
+  get_agent_defaults_voice_agents_defaults_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/global-settings
+   * Org-wide inbound call defaults
+   * tier: read · scope: voice:read
+   */
+  get_agent_global_settings_voice_agents_global_settings_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/skill-stats
+   * Run statistics for an agent's skills
+   * tier: read · scope: voice:read
+   */
+  get_agent_skill_stats_voice_agents__agent_id__skill_stats_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    query?: {
+      /** Look-back window in days. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/test-suite-status
+   * The activation gate: does the saved suite vouch for this config?
+   * tier: read · scope: voice:read
+   */
+  get_agent_test_suite_status_voice_agents__agent_id__test_suite_status_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/inbound-routing/business-hours
+   * Read the business-hours schedule for a number
+   * tier: read · scope: voice:read
+   */
+  get_business_hours_voice_inbound_routing_business_hours_get: {
+    input: {
+    query: {
+      /** The number to read. */
+      phone_number: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/mcp-servers/{mcp_server_id}/tools/cached
+   * Last known tool list for an MCP server
+   * tier: read · scope: voice:read
+   */
+  get_cached_mcp_tools_voice_mcp_servers__mcp_server_id__tools_cached_get: {
+    input: {
+    path: {
+      /** MCP server id. */
+      mcp_server_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/calls/{call_id}/artifacts
+   * Whether a call's transcript and recording are ready
+   * tier: read · scope: voice:read
+   */
+  get_call_artifacts_voice_calls__call_id__artifacts_get: {
+    input: {
+    path: {
+      /** Call id. */
+      call_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/dialer/calls/{room_name}/grading
+   * Get AI call grading for a single dialer call
+   * tier: read · scope: voice:read
+   */
+  get_call_grading_voice_dialer_calls__room_name__grading_get: {
+    input: {
+    path: {
+      /** LiveKit room / call identifier (`livekit_room_name`). */
+      room_name: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CallGradingResponse_;
+  };
+  /**
+   * GET /voice/dialer/calls/{room_name}/transcript
+   * Get the persisted transcript for a single dialer call
+   * tier: read · scope: voice:read
+   */
+  get_call_transcript_voice_dialer_calls__room_name__transcript_get: {
+    input: {
+    path: {
+      /** LiveKit room / call identifier (`livekit_room_name`). */
+      room_name: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CallTranscriptResponse_;
+  };
+  /**
+   * POST /voice/chat-agent/history
+   * Read a chat agent conversation
+   * tier: read · scope: voice:read
+   */
+  get_chat_agent_history_voice_chat_agent_history_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}
+   * Get one collection
+   * tier: read · scope: voice:read
+   */
+  get_collection_voice_collections__collection_id__get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}/files/download-url
+   * Get a temporary download URL for one file
+   * tier: read · scope: voice:read
+   */
+  get_collection_file_download_url_voice_collections__collection_id__files_download_url_get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query: {
+      /** File name within the collection. */
+      filename: string;
+      /** Folder inside the collection. Empty is the root. */
+      folder_path?: string;
+      /** How long the URL stays valid, in seconds. */
+      expiration?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}/stats
+   * File statistics for a collection
+   * tier: read · scope: voice:read
+   */
+  get_collection_stats_voice_collections__collection_id__stats_get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}/vector-status
+   * Indexing status for a collection
+   * tier: read · scope: voice:read
+   */
+  get_collection_vector_status_voice_collections__collection_id__vector_status_get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/company-knowledge
+   * Get the organisation's company knowledge
+   * tier: read · scope: voice:read
+   */
+  get_company_knowledge_voice_company_knowledge_get: {
+    input: {
+    query?: {
+      /** False forces a fresh read. The cache is short-lived; prefer the default. */
+      use_cache?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /dialer/sessions/{session_id}
+   * One dialer session
+   * tier: read · scope: voice:read
+   */
+  get_dialer_session_dialer_sessions__session_id__get: {
+    input: {
+    path: {
+      /** Dialer session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /dialer/settings/{user_email}
+   * A rep's dialer settings
+   * tier: read · scope: voice:read
+   */
+  get_dialer_settings_dialer_settings__user_email__get: {
+    input: {
+    path: {
+      /** The rep. */
+      user_email: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/dialer/stats
+   * Parallel dialer analytics report
+   * tier: read · scope: voice:read
+   */
+  get_dialer_stats_voice_dialer_stats_get: {
+    input: {
+    query?: {
+      /** Filter to a single session. */
+      session_id?: string | null;
+      /** Filter to one SDR's calls. */
+      user_email?: string | null;
+      /** Start date "YYYY-MM-DD". */
+      date_from?: string | null;
+      /** End date "YYYY-MM-DD". */
+      date_to?: string | null;
+      /** "DAILY" for per-day rows, "TOTAL" for one summary row. */
+      aggregation?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DialerStatsResponse_;
+  };
+  /**
+   * GET /dialer/dispositions/{disposition_id}/usage
+   * Whether a custom disposition is in use
+   * tier: read · scope: voice:read
+   */
+  get_disposition_usage_dialer_dispositions__disposition_id__usage_get: {
+    input: {
+    path: {
+      /** Custom disposition id. */
+      disposition_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/company-knowledge/formatted
+   * Get company knowledge as the agent prompt sees it
+   * tier: read · scope: voice:read
+   */
+  get_formatted_company_knowledge_voice_company_knowledge_formatted_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/jobs/{job_id}
+   * Poll an async job
+   * tier: read · scope: voice:read
+   */
+  get_job_voice_jobs__job_id__get: {
+    input: {
+    path: {
+      /** Job id from a 202 response. */
+      job_id: string;
+    };
+    query?: {
+      /** Which queue the job was placed on. */
+      queue?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/campaigns/onboarding/threads/{thread_id}
+   * Read an onboarding thread's messages
+   * tier: read · scope: voice:read
+   */
+  get_onboarding_thread_voice_campaigns_onboarding_threads__thread_id__get: {
+    input: {
+    path: {
+      /** Thread id. */
+      thread_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/campaigns/past-conversation
+   * Summary of prior conversation with one contact
+   * tier: read · scope: voice:read
+   */
+  get_past_conversation_voice_campaigns_past_conversation_get: {
+    input: {
+    query: {
+      /** Contact id. */
+      contact_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/twins/{agent_id}
+   * Get a digital twin
+   * tier: read · scope: voice:read
+   */
+  get_twin_voice_twins__agent_id__get: {
+    input: {
+    path: {
+      /** Twin id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/video-recordings/{video_id}
+   * Get a video recording with its transcript
+   * tier: read · scope: voice:read
+   */
+  get_video_recording_voice_video_recordings__video_id__get: {
+    input: {
+    path: {
+      /** Recording id. */
+      video_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/video-recordings/{video_id}/url
+   * Get a temporary playback URL for a recording
+   * tier: read · scope: voice:read
+   */
+  get_video_recording_url_voice_video_recordings__video_id__url_get: {
+    input: {
+    path: {
+      /** Recording id. */
+      video_id: string;
+    };
+    query?: {
+      /** How long the URL stays valid, in seconds. */
+      expiration?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}
+   * Get a voice agent or twin by id
+   * tier: read · scope: voice:read
+   */
+  get_voice_agent_voice_agents__agent_id__get: {
+    input: {
+    path: {
+      /** Agent UUID. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceAgentResponse_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/documents
+   * An agent's documents
+   * tier: read · scope: voice:read
+   */
+  list_agent_documents_voice_agents__agent_id__documents_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agent-phone-numbers
+   * Numbers free to give an agent, and numbers already given
+   * tier: read · scope: voice:read
+   */
+  list_agent_phone_numbers_voice_agent_phone_numbers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/skills
+   * An agent's skills
+   * tier: read · scope: voice:read
+   */
+  list_agent_skills_voice_agents__agent_id__skills_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agent-templates
+   * Agent templates
+   * tier: read · scope: voice:read
+   */
+  list_agent_templates_voice_agent_templates_get: {
+    input: {
+    query?: {
+      /** Only agents, or only twins. */
+      entity_type?: ("agent" | "twin") | null;
+      /** Include graph8's own templates. */
+      include_system_templates?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/test-cases
+   * The agent's saved evaluation cases
+   * tier: read · scope: voice:read
+   */
+  list_agent_test_cases_voice_agents__agent_id__test_cases_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/agents/{agent_id}/test-runs
+   * Run history, newest first
+   * tier: read · scope: voice:read
+   */
+  list_agent_test_runs_voice_agents__agent_id__test_runs_get: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    query?: {
+      /** Only runs of this saved case. */
+      test_case_id?: string | null;
+      limit?: number;
+      /** Include the stored previews (heavier). */
+      include_output?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/collections/files
+   * List every file across every collection
+   * tier: read · scope: voice:read
+   */
+  list_all_collection_files_voice_collections_files_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/call-results/campaigns
+   * Campaign ids that have at least one call
+   * tier: read · scope: voice:read
+   */
+  list_call_result_campaigns_voice_call_results_campaigns_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/dialer/calls
+   * List dialer calls (filter by contact, SDR, or session)
+   * tier: read · scope: voice:read
+   */
+  list_calls_for_contact_voice_dialer_calls_get: {
+    input: {
+    query?: {
+      /** CDP contact id (string form of mashup_contacts.id). If you only have a CRM-overlay id (cb_contact_extensions.id), resolve it via the contacts endpoint first. Optional - supply at least one of contact_id, user_email, or parallel_session_id. */
+      contact_id?: string | null;
+      /** SDR email. Returns dialer calls where the parent ParallelDialSession.user_email matches. Use for incremental ingestion of one SDR's call history. */
+      user_email?: string | null;
+      /** Filter to a single ParallelDialSession.session_id. */
+      parallel_session_id?: string | null;
+      /** ISO-8601 timestamp. Only return calls with created_at >= this value. Use for incremental polling (pass the max created_at from the previous page on the next call). */
+      created_after?: string | null;
+      /** Max calls to return, newest first. Capped at 100. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CallsListResponse_;
+  };
+  /**
+   * GET /voice/campaigns/email-models
+   * Models available for email generation
+   * tier: read · scope: voice:read
+   */
+  list_campaign_email_models_voice_campaigns_email_models_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * POST /voice/chat-agent/conversations
+   * List chat agent conversations
+   * tier: read · scope: voice:read
+   */
+  list_chat_agent_conversations_voice_chat_agent_conversations_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/voice-library/voices
+   * The voices this organisation has cloned
+   * tier: read · scope: voice:read
+   */
+  list_cloned_voices_voice_voice_library_voices_get: {
+    input: {
+    query?: {
+      /** Only voices cloned by this user. */
+      created_by_email?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/collections
+   * List knowledge collections
+   * tier: read · scope: voice:read
+   */
+  list_collections_voice_collections_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/phone-directory/departments/{department}
+   * One department's reachable members
+   * tier: read · scope: voice:read
+   */
+  list_department_colleagues_voice_phone_directory_departments__department__get: {
+    input: {
+    path: {
+      /** Department name; matched case-insensitively. */
+      department: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/dialer/agents
+   * List voice agents available for a dialer session
+   * tier: read · scope: voice:read
+   */
+  list_dialer_agents_voice_dialer_agents_get: {
+    input: {
+    query?: {
+      /** Filter by agent role (e.g. "SDR", "AE", "Receptionist", "CSM"). */
+      role?: string | null;
+      /** Filter by status (e.g. "active"). Defaults to all. */
+      agent_status?: string | null;
+      /** "agent" or "twin". Defaults to all. */
+      entity_type?: string | null;
+      /** Substring match on agent name. */
+      search?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DialerAgentsListResponse_;
+  };
+  /**
+   * GET /voice/dialer/numbers
+   * List dialer-eligible phone numbers
+   * tier: read · scope: voice:read
+   */
+  list_dialer_numbers_voice_dialer_numbers_get: {
+    input: {
+    query?: {
+      /** Optional - restrict to numbers assigned to a specific SDR. */
+      user_email?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DialerNumbersListResponse_;
+  };
+  /**
+   * GET /voice/dialer/sessions
+   * List parallel dialer sessions
+   * tier: read · scope: voice:read
+   */
+  list_dialer_sessions_voice_dialer_sessions_get: {
+    input: {
+    query?: {
+      /** Page number (1-indexed). */
+      page?: number;
+      /** Sessions per page (max 200). */
+      page_size?: number;
+      /** Comma-separated session statuses (e.g. "ACTIVE,PAUSED"). */
+      status?: string | null;
+      /** Filter by SDR email (substring). */
+      user_email?: string | null;
+      /** Filter by session name (substring). */
+      name?: string | null;
+      /** Filter by campaign id (substring). */
+      campaign_id?: string | null;
+      /** Filter by list id stored in session metadata. */
+      list_id?: string | null;
+      /** Filter by list title (substring). */
+      list_name?: string | null;
+      /** ISO timestamp - sessions created on/after. */
+      date_from?: string | null;
+      /** ISO timestamp - sessions created on/before. */
+      date_to?: string | null;
+      /** Column to sort on (e.g. "created_at", "updated_at", "total_calls"). */
+      sort_by?: string | null;
+      /** "asc" or "desc". Defaults to desc. */
+      sort_order?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DialerSessionsListResponse_;
+  };
+  /**
+   * GET /voice/call-results/inbound
+   * Inbound call results
+   * tier: read · scope: voice:read
+   */
+  list_inbound_call_results_voice_call_results_inbound_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/inbound-routing/rules
+   * List inbound routing rules
+   * tier: read · scope: voice:read
+   */
+  list_inbound_routes_voice_inbound_routing_rules_get: {
+    input: {
+    query?: {
+      /** Only rules for this number. */
+      phone_number?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/knowledge-base/files
+   * Files in the organisation knowledge base
+   * tier: read · scope: voice:read
+   */
+  list_knowledge_base_files_voice_knowledge_base_files_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/mcp-servers/{mcp_server_id}/tools
+   * Live tool list from an MCP server
+   * tier: external · scope: voice:run
+   */
+  list_mcp_server_tools_voice_mcp_servers__mcp_server_id__tools_get: {
+    input: {
+    path: {
+      /** MCP server id. */
+      mcp_server_id: string;
+    };
+    query?: {
+      /** True re-reads from the server and replaces the cache. */
+      refresh?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/dialer/missed-callbacks
+   * List missed inbound callbacks
+   * tier: read · scope: voice:read
+   */
+  list_missed_callbacks_voice_dialer_missed_callbacks_get: {
+    input: {
+    query?: {
+      /** Max rows to return. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_MissedCallbacksResponse_;
+  };
+  /**
+   * GET /voice/campaigns/onboarding/threads
+   * List onboarding conversation threads
+   * tier: read · scope: voice:read
+   */
+  list_onboarding_threads_voice_campaigns_onboarding_threads_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/campaigns/past-conversations
+   * All recorded conversation history for one contact
+   * tier: read · scope: voice:read
+   */
+  list_past_conversations_voice_campaigns_past_conversations_get: {
+    input: {
+    query: {
+      /** Contact id. */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/inbound-calls/pending
+   * Inbound calls ringing right now
+   * tier: read · scope: voice:read
+   */
+  list_pending_inbound_calls_voice_inbound_calls_pending_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/phone-directory
+   * The organisation's phone directory
+   * tier: read · scope: voice:read
+   */
+  list_phone_directory_voice_phone_directory_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/voice-library/presets
+   * List the preset voices an agent can speak with
+   * tier: read · scope: voice:read
+   */
+  list_preset_voices_voice_voice_library_presets_get: {
+    input: {
+    query?: {
+      /** Rows to return. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/phone-directory/reachable
+   * Colleagues who can be reached right now
+   * tier: read · scope: voice:read
+   */
+  list_reachable_colleagues_voice_phone_directory_reachable_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/collections/{collection_id}/scrape-sources
+   * List the web sources feeding a collection
+   * tier: read · scope: voice:read
+   */
+  list_scrape_sources_voice_collections__collection_id__scrape_sources_get: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/twins
+   * The organisation's twins
+   * tier: read · scope: voice:read
+   */
+  list_twins_voice_twins_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/video-recordings
+   * List video recordings
+   * tier: read · scope: voice:read
+   */
+  list_video_recordings_voice_video_recordings_get: {
+    input: {
+    query?: {
+      /** Only recordings for this subject (candidate, employee, ...). */
+      user_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /voice/agents
+   * List voice agents and twins
+   * tier: read · scope: voice:read
+   */
+  list_voice_agents_voice_agents_get: {
+    input: {
+    query?: {
+      /** Filter by entity type ("agent" or "twin"). */
+      entity_type?: string | null;
+      /** Filter by agent role. */
+      role?: string | null;
+      /** Filter by status. */
+      agent_status?: string | null;
+      /** true=templates only, false=non-templates only. */
+      is_template?: boolean | null;
+      /** Substring match on agent name. */
+      search?: string | null;
+      /** Page number (1-indexed). */
+      page?: number;
+      /** Results per page (max 100). */
+      page_size?: number;
+      /** "created_at" | "agent_name" | "role" | "status". */
+      sort_by?: string;
+      /** "asc" or "desc". */
+      sort_order?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceAgentListResponse_;
+  };
+  /**
+   * GET /voice/dispositions
+   * List system + org custom call dispositions
+   * tier: read · scope: voice:read
+   */
+  list_voice_dispositions_voice_dispositions_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceDispositionListResponse_;
+  };
+  /**
+   * GET /voice/voicemails
+   * List voicemails
+   * tier: read · scope: voice:read
+   */
+  list_voicemails_voice_voicemails_get: {
+    input: {
+    query?: {
+      /** True for read only, false for unread only. Omit for both. */
+      is_read?: boolean | null;
+      /** Only voicemails assigned to this rep. */
+      sdr_email?: string | null;
+      /** Rows per page. */
+      limit?: number;
+      /** Rows to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * POST /dialer/parallel-calls/sessions/{session_id}/calls
+   * Call results for chosen contacts in a parallel session
+   * tier: read · scope: voice:read
+   */
+  lookup_session_calls_dialer_parallel_calls_sessions__session_id__calls_post: {
+    input: {
+    path: {
+      /** Dialer session id. */
+      session_id: string;
+    };
+    query?: {
+      /** Latest call plus history per contact, or a flat list. */
+      group_by_contact?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SessionCallsLookup;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/voicemails/read-all
+   * Mark every voicemail read
+   * tier: write · scope: voice:write
+   */
+  mark_all_voicemails_read_voice_voicemails_read_all_patch: {
+    input: {
+    query: {
+      /** Who is marking them read. Recorded against each row. */
+      sdr_email: string;
+      /** Narrow to one rep's voicemails. OMITTING THIS CLEARS THE WHOLE ORGANISATION'S unread state, not just this rep's. */
+      assigned_to?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/voicemails/{voicemail_id}/read
+   * Mark one voicemail read
+   * tier: write · scope: voice:write
+   */
+  mark_voicemail_read_voice_voicemails__voicemail_id__read_patch: {
+    input: {
+    path: {
+      /** Voicemail id. */
+      voicemail_id: number;
+    };
+    query: {
+      /** Who read it. Recorded against the row. */
+      sdr_email: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/files/paste-text
+   * Create a text file in a collection from pasted content
+   * tier: billable · scope: voice:run
+   */
+  paste_text_into_collection_voice_collections__collection_id__files_paste_text_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CollectionPasteText;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /dialer/sessions/{session_id}/pause
+   * Pause a dialer session
+   * tier: write · scope: voice:write
+   */
+  pause_dialer_session_dialer_sessions__session_id__pause_post: {
+    input: {
+    path: {
+      /** Dialer session id. */
+      session_id: string;
+    };
+    query?: {
+      /** The rep pausing, for the session log. */
+      user_email?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/reindex
+   * Rebuild a collection's vector index
+   * tier: billable · scope: voice:run
+   */
+  reindex_collection_voice_collections__collection_id__reindex_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/chat-agent/conversations/{chat_id}/name
+   * Rename a chat agent conversation
+   * tier: write · scope: voice:write
+   */
+  rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put: {
+    input: {
+    path: {
+      /** Conversation id. */
+      chat_id: string;
+    };
+    query: {
+      /** The agent that owns it. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/collections/{collection_id}/files/rename
+   * Rename or move a file within a collection
+   * tier: write · scope: voice:write
+   */
+  rename_collection_file_voice_collections__collection_id__files_rename_put: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query: {
+      /** Current file name. */
+      old_filename: string;
+      /** New file name. */
+      new_filename: string;
+      /** Current folder. Empty is the root. */
+      old_folder_path?: string;
+      /** Target folder. Empty is the root. */
+      new_folder_path?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/knowledge-base/files/rename
+   * Rename a knowledge-base file
+   * tier: write · scope: voice:write
+   */
+  rename_knowledge_base_file_voice_knowledge_base_files_rename_put: {
+    input: {
+    query: {
+      /** Current name. */
+      old_filename: string;
+      /** New name. */
+      new_filename: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/research/business-data
+   * Business profile for a company website
+   * tier: billable · scope: voice:run
+   */
+  research_business_data_voice_research_business_data_get: {
+    input: {
+    query: {
+      /** The company website to work from. */
+      customer_url: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/research/company
+   * Deep-research a company
+   * tier: billable · scope: voice:run
+   */
+  research_company_voice_research_company_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_research_company_voice_research_company_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/research/competitors
+   * Competitors of a company
+   * tier: billable · scope: voice:run
+   */
+  research_competitors_voice_research_competitors_get: {
+    input: {
+    query: {
+      /** The company website to work from. */
+      customer_url: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/research/faq
+   * FAQs extracted from a company website
+   * tier: billable · scope: voice:run
+   */
+  research_faq_voice_research_faq_get: {
+    input: {
+    query: {
+      /** The company website to work from. */
+      customer_url: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/research/keywords
+   * Search keywords and paid-search data for a company
+   * tier: billable · scope: voice:run
+   */
+  research_keywords_voice_research_keywords_get: {
+    input: {
+    query: {
+      /** The company website to work from. */
+      customer_url: string;
+      /** True returns a job id immediately (202) instead of waiting. Poll `GET /voice/jobs/{job_id}` for the result. */
+      run_async?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/research/org-chart
+   * Research a company's org chart
+   * tier: billable · scope: voice:run
+   */
+  research_org_chart_voice_research_org_chart_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_research_org_chart_voice_research_org_chart_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /voice/research/prospect-company
+   * Competitor and signal profile for a prospect's company
+   * tier: billable · scope: voice:run
+   */
+  research_prospect_company_voice_research_prospect_company_get: {
+    input: {
+    query: {
+      /** Prospect's company name. */
+      company_name: string;
+      /** Prospect's company website. */
+      company_website: string;
+      /** What the company does, if known. */
+      company_description?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/research/prospect-data
+   * Extract prospect data from a form submission
+   * tier: billable · scope: voice:run
+   */
+  research_prospect_data_voice_research_prospect_data_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/research/prospect-profile
+   * Generate a full prospect profile
+   * tier: billable · scope: voice:run
+   */
+  research_prospect_profile_voice_research_prospect_profile_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/dialer/sessions/{session_id}/resume
+   * Resume a paused parallel-dialer session by auto-fetching next batch
+   * tier: external · scope: voice:run
+   */
+  resume_dialer_session_voice_dialer_sessions__session_id__resume_post: {
+    input: {
+    path: {
+      /** Session UUID. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: DialerSessionResumeRequest;
+  };
+    output: ApiResponse_DialerSessionResumeResponse_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/test
+   * Dry-run one case, saved or ad-hoc
+   * tier: write · scope: voice:write
+   */
+  run_agent_test_voice_agents__agent_id__test_post: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentTestRun;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/test/run-all
+   * Regression run: every saved case, plus the activation gate
+   * tier: write · scope: voice:write
+   */
+  run_all_agent_tests_voice_agents__agent_id__test_run_all_post: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: AgentRegressionRun | null;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/onboarding/threads/actions
+   * Run an action the onboarding agent proposed
+   * tier: billable · scope: voice:run
+   */
+  run_onboarding_thread_action_voice_campaigns_onboarding_threads_actions_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/scrape-sources/{source_id}/run
+   * Scrape a source now
+   * tier: billable · scope: voice:run
+   */
+  run_scrape_source_voice_collections__collection_id__scrape_sources__source_id__run_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+      /** Scrape source id. */
+      source_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/save-as-template
+   * Save an agent as a reusable template
+   * tier: write · scope: voice:write
+   */
+  save_agent_as_template_voice_agents__agent_id__save_as_template_post: {
+    input: {
+    path: {
+      /** The agent to templatise. */
+      agent_id: string;
+    };
+    query?: {
+      /** Template name. Defaults to the agent's own name. */
+      template_name?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/documents/search
+   * Search an agent's documents
+   * tier: read · scope: voice:read
+   */
+  search_agent_documents_voice_agents__agent_id__documents_search_post: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentDocumentSearch;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/call-results/search
+   * Search call results
+   * tier: read · scope: voice:read
+   */
+  search_call_results_voice_call_results_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * POST /voice/chats/search
+   * Search web-chat conversations
+   * tier: read · scope: voice:read
+   */
+  search_chats_voice_chats_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * POST /voice/collections/search
+   * Search across collections
+   * tier: read · scope: voice:read
+   */
+  search_collections_voice_collections_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CollectionSearch;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/chat-agent/messages
+   * Send a message to the chat agent
+   * tier: billable · scope: voice:run
+   */
+  send_chat_agent_message_voice_chat_agent_messages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/onboarding/messages
+   * Talk to the campaign onboarding agent
+   * tier: billable · scope: voice:run
+   */
+  send_onboarding_message_voice_campaigns_onboarding_messages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/receptionist/messages
+   * Send a text message to the receptionist
+   * tier: billable · scope: voice:run
+   */
+  send_receptionist_message_voice_receptionist_messages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/global-settings
+   * Set org-wide inbound call defaults
+   * tier: write · scope: voice:write
+   */
+  set_agent_global_settings_voice_agents_global_settings_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/voice-library/onboarding-voice
+   * Replace the organisation's onboarding voice
+   * tier: billable · scope: voice:run
+   */
+  set_onboarding_voice_voice_voice_library_onboarding_voice_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/calls
+   * Dispatch one ad-hoc AI-agent call to a raw number
+   * tier: external · scope: voice:run
+   */
+  start_voice_call_voice_calls_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceCallStartRequest;
+  };
+    output: ApiResponse_VoiceCallStartResponse_;
+  };
+  /**
+   * POST /dialer/sessions/{session_id}/stop
+   * Stop a dialer session
+   * tier: write · scope: voice:write
+   */
+  stop_dialer_session_dialer_sessions__session_id__stop_post: {
+    input: {
+    path: {
+      /** Dialer session id. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/campaigns/memory
+   * Record past campaign history for a contact
+   * tier: write · scope: voice:write
+   */
+  store_campaign_memory_voice_campaigns_memory_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_store_campaign_memory_voice_campaigns_memory_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/sync
+   * Reconcile a collection's records with its stored files
+   * tier: write · scope: voice:write
+   */
+  sync_collection_voice_collections__collection_id__sync_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    query?: {
+      /** Report what would change without changing it. */
+      dry_run?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/mcp-servers/{mcp_server_id}/test
+   * Test the connection to a saved MCP server
+   * tier: external · scope: voice:run
+   */
+  test_mcp_server_voice_mcp_servers__mcp_server_id__test_post: {
+    input: {
+    path: {
+      /** Saved MCP server id. */
+      mcp_server_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/agents/receptionist
+   * Turn the receptionist on or off
+   * tier: write · scope: voice:write
+   */
+  toggle_receptionist_agent_voice_agents_receptionist_patch: {
+    input: {
+    query: {
+      /** Explicit, not a toggle: a retried request is idempotent instead of flipping the receptionist back on. */
+      enabled: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/call-flow-examples/transcribe
+   * Transcribe a recorded call into the org's call-flow example
+   * tier: billable · scope: voice:run
+   */
+  transcribe_call_flow_example_voice_call_flow_examples_transcribe_post: {
+    input: {
+    query?: {
+      /** Language spoken in the recording. */
+      language?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/chat-agent/conversations/{chat_id}/transfer-to-human
+   * Hand a chat agent conversation to a person
+   * tier: write · scope: voice:write
+   */
+  transfer_chat_agent_conversation_voice_chat_agent_conversations__chat_id__transfer_to_human_post: {
+    input: {
+    path: {
+      /** Conversation id. */
+      chat_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/memory
+   * Record a conversation into an agent's memory of a contact
+   * tier: write · scope: voice:write
+   */
+  update_agent_memory_voice_agents__agent_id__memory_post: {
+    input: {
+    path: {
+      /** The agent doing the remembering. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_update_agent_memory_voice_agents__agent_id__memory_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/agents/{agent_id}/test-cases/{test_case_id}
+   * Edit a saved case
+   * tier: write · scope: voice:write
+   */
+  update_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__put: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+      /** Saved test case id. */
+      test_case_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AgentTestCaseUpdate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/collections/{collection_id}
+   * Rename or re-describe a collection
+   * tier: write · scope: voice:write
+   */
+  update_collection_voice_collections__collection_id__put: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CollectionUpdateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/company-knowledge
+   * Update the organisation's company knowledge
+   * tier: write · scope: voice:write
+   */
+  update_company_knowledge_voice_company_knowledge_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/dialer/sessions/{session_id}/status
+   * Pause, resume, or stop a parallel-dialer session
+   * tier: external · scope: voice:run
+   */
+  update_dialer_session_status_voice_dialer_sessions__session_id__status_patch: {
+    input: {
+    path: {
+      /** Session UUID. */
+      session_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DialerSessionStatusUpdateRequest;
+  };
+    output: ApiResponse_DialerSessionStatusUpdateResponse_;
+  };
+  /**
+   * PUT /dialer/settings
+   * Change a rep's dialer settings
+   * tier: write · scope: voice:write
+   */
+  update_dialer_settings_dialer_settings_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DialerSettingsUpdate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/inbound-routing/rules/{route_id}
+   * Update an inbound routing rule
+   * tier: write · scope: voice:write
+   */
+  update_inbound_route_voice_inbound_routing_rules__route_id__patch: {
+    input: {
+    path: {
+      /** Rule id. */
+      route_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: InboundRouteUpdateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/mcp-servers/{mcp_server_id}
+   * Update an MCP server
+   * tier: write · scope: voice:write
+   */
+  update_mcp_server_voice_mcp_servers__mcp_server_id__put: {
+    input: {
+    path: {
+      /** MCP server id. */
+      mcp_server_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: McpServerUpdateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/phone-directory/{entry_id}
+   * Edit a directory entry
+   * tier: write · scope: voice:write
+   */
+  update_phone_directory_entry_voice_phone_directory__entry_id__put: {
+    input: {
+    path: {
+      /** Directory entry id. */
+      entry_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PhoneDirectoryEntryUpdate;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PATCH /voice/collections/{collection_id}/scrape-sources/{source_id}
+   * Change a web source's cadence, ceiling, or pause it
+   * tier: write · scope: voice:write
+   */
+  update_scrape_source_voice_collections__collection_id__scrape_sources__source_id__patch: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+      /** Scrape source id. */
+      source_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ScrapeSourceUpdateRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/twins/{agent_id}
+   * Edit a twin, optionally with a new writing-style document
+   * tier: write · scope: voice:write
+   */
+  update_twin_voice_twins__agent_id__put: {
+    input: {
+    path: {
+      /** Twin agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/agents/{agent_id}
+   * Update a voice agent or twin
+   * tier: write · scope: voice:write
+   */
+  update_voice_agent_voice_agents__agent_id__put: {
+    input: {
+    path: {
+      /** Agent UUID. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceAgentUpdateRequest;
+  };
+    output: ApiResponse_VoiceAgentResponse_;
+  };
+  /**
+   * PATCH /voice/dispositions/{disposition_id}
+   * Edit a custom call disposition
+   * tier: external · scope: voice:run
+   */
+  update_voice_disposition_voice_dispositions__disposition_id__patch: {
+    input: {
+    path: {
+      /** Custom disposition id. */
+      disposition_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VoiceCustomDispositionUpdateRequest;
+  };
+    output: ApiResponse_VoiceCustomDispositionItem_;
+  };
+  /**
+   * POST /voice/agents/{agent_id}/documents/upload
+   * Upload documents into an agent's own vector store
+   * tier: billable · scope: voice:run
+   */
+  upload_agent_documents_voice_agents__agent_id__documents_upload_post: {
+    input: {
+    path: {
+      /** Voice agent id. */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/files/upload
+   * Upload one file into a collection
+   * tier: billable · scope: voice:run
+   */
+  upload_collection_file_voice_collections__collection_id__files_upload_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/collections/{collection_id}/files/upload-multiple
+   * Upload several files into a collection
+   * tier: billable · scope: voice:run
+   */
+  upload_collection_files_voice_collections__collection_id__files_upload_multiple_post: {
+    input: {
+    path: {
+      /** Collection id. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/knowledge-base/files/upload
+   * Upload a file to the org-wide knowledge base
+   * tier: billable · scope: voice:run
+   */
+  upload_knowledge_base_file_voice_knowledge_base_files_upload_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /voice/video-recordings/upload
+   * Upload a video recording for transcription
+   * tier: billable · scope: voice:run
+   */
+  upload_video_recording_voice_video_recordings_upload_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /voice/inbound-routing/business-hours
+   * Set the business-hours schedule for a number
+   * tier: write · scope: voice:write
+   */
+  upsert_business_hours_voice_inbound_routing_business_hours_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BusinessHoursScheduleRequest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+}
+
+// 97 schemas referenced above (the same as G8Contract.<Name>).
+
+/**
+ * voice binds `query` and `top_k` as FORM fields beside `org_id` and
+ * `agent_id`; the router re-encodes this body as form data.
+ */
+export interface AgentDocumentSearch {
+  query: string;
+  top_k?: number;
+}
+
+export interface AgentRegressionRun {
+  /** Attribution; defaults to the key's identity. */
+  triggered_by?: string | null;
+}
+
+/**
+ * A saved evaluation case: the user turn under test and what must hold.
+ *
+ * `llm_judge` may be SAVED but is skipped by dry runs - a judge needs a real
+ * completion, and a dry run never calls a model.
+ */
+export interface AgentTestCaseCreate {
+  /** Assertion options: target (resolved_instructions | tool_names | grounding_sources), case_sensitive, tool, collection_id, capability_tools, refusal_markers. */
+  assertion_config?: Record<string, unknown> | null;
+  assertion_type?: "exact" | "contains" | "not_contains" | "expects_tool" | "refuses" | "cites_collection" | "llm_judge";
+  /** Selects the per-channel instructions. */
+  channel?: "chat" | "inbound" | "outbound";
+  /** Attribution; defaults to the key's identity. */
+  created_by?: string | null;
+  /** What the assertion compares against; a tool name or list for expects_tool. */
+  expected_output?: unknown | null;
+  /** Surrounding facts held constant (prior turns, contact, company). */
+  input_context?: Record<string, unknown> | null;
+  /** The user turn under test. */
+  input_message: string;
+  name: string;
+}
+
+export interface AgentTestCaseUpdate {
+  assertion_config?: Record<string, unknown> | null;
+  assertion_type?: ("exact" | "contains" | "not_contains" | "expects_tool" | "refuses" | "cites_collection" | "llm_judge") | null;
+  channel?: ("chat" | "inbound" | "outbound") | null;
+  expected_output?: unknown | null;
+  input_context?: Record<string, unknown> | null;
+  input_message?: string | null;
+  name?: string | null;
+}
+
+/**
+ * One dry run. Exactly one source: `test_case_id` (a saved case) or
+ * `input_message` (ad-hoc). Never calls a model, never places a call, never
+ * sends a message - it resolves what the agent WOULD receive and reach for.
+ */
+export interface AgentTestRun {
+  assertion_config?: Record<string, unknown> | null;
+  assertion_type?: ("exact" | "contains" | "not_contains" | "expects_tool" | "refuses" | "cites_collection" | "llm_judge") | null;
+  channel?: ("chat" | "inbound" | "outbound") | null;
+  expected_output?: unknown | null;
+  input_context?: Record<string, unknown> | null;
+  input_message?: string | null;
+  /** preview | dry_run - both resolve configuration only. */
+  mode?: ("preview" | "dry_run") | null;
+  test_case_id?: string | null;
+  triggered_by?: string | null;
+}
+
+export interface ApiResponse_CallGradingResponse_ {
+  data: CallGradingResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CallTranscriptResponse_ {
+  data: CallTranscriptResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CallsListResponse_ {
+  data: CallsListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerAgentsListResponse_ {
+  data: DialerAgentsListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerNumbersListResponse_ {
+  data: DialerNumbersListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerSessionCreateResponse_ {
+  data: DialerSessionCreateResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerSessionResumeResponse_ {
+  data: DialerSessionResumeResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerSessionStatusUpdateResponse_ {
+  data: DialerSessionStatusUpdateResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerSessionsListResponse_ {
+  data: DialerSessionsListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_DialerStatsResponse_ {
+  data: DialerStatsResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_MissedCallbacksResponse_ {
+  data: MissedCallbacksResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceAgentListResponse_ {
+  data: VoiceAgentListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceAgentResponse_ {
+  data: VoiceAgentResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceCallStartResponse_ {
+  data: VoiceCallStartResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceCustomDispositionItem_ {
+  data: VoiceCustomDispositionItem;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceDispositionListResponse_ {
+  data: VoiceDispositionListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoiceListPayload_ {
+  data: VoiceListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoicePayload_ {
+  data: VoicePayload;
+  pagination?: PaginationMeta | null;
+}
+
+/** voice `BatchEmailRequest`: one compose or respond job inside a batch. */
+export interface BatchEmailItem {
+  /** Instructions for either kind. */
+  context?: string | null;
+  /** respond: the body being answered. */
+  email_to_respond_body?: string | null;
+  /** respond: the subject being answered. */
+  email_to_respond_subject?: string | null;
+  /** compose: the register. */
+  email_type?: string | null;
+  /** compose: who it is to. */
+  recipient_info?: string | null;
+  /** respond: the register. */
+  response_type?: string | null;
+  /** respond: who sent it. */
+  sender_info?: string | null;
+  /** respond: earlier messages. */
+  thread_emails?: Array<EmailThreadMessage> | null;
+  /** respond: the thread id. */
+  thread_id?: string | null;
+  /** compose a new email, or respond to one. */
+  type: "compose" | "respond";
+}
+
+/** voice `BatchEmailProcessingRequest`, without `org_id` / `agent_settings`. */
+export interface BatchEmailProcessing {
+  agent_id: string;
+  contact_id: string;
+  emails: Array<BatchEmailItem>;
+  /** openai: gpt-4o or gpt-4o-mini. anthropic: claude-sonnet-4-6, claude-haiku-4-5-20251001 or claude-opus-4-6. Voice rejects any other pairing with a 422. */
+  model?: string;
+  /** LLM provider. */
+  provider?: "openai" | "anthropic" | "openrouter";
+}
+
+export interface Body_attach_skills_to_agent_voice_agents__agent_id__skills_post {
+  /** Skill `action_id`s. Additive - existing skills are kept. */
+  action_ids: Array<unknown>;
+}
+
+export interface Body_clone_agent_voice_agents_clone_post {
+  /** Override: "agent" or "twin". */
+  entity_type?: string | null;
+  /** Id for the copy. Generated when omitted. */
+  new_agent_id?: string | null;
+  /** Name for the copy. */
+  new_agent_name: string;
+  /** Field overrides applied to the copy. */
+  overrides?: Record<string, unknown> | null;
+  /** Override the role. */
+  role?: string | null;
+  /** Agent or template to copy. */
+  source_agent_id: string;
+}
+
+export interface Body_decline_inbound_call_voice_inbound_calls_decline_post {
+  /** "hangup" ends the call. Voice treats anything else as a decline. */
+  action?: string;
+  /** The ringing call's room name. */
+  room_name: string;
+}
+
+export interface Body_rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put {
+  /** The new name. */
+  name: string;
+}
+
+export interface Body_research_company_voice_research_company_post {
+  /** Company to research. */
+  company_name: string;
+  /** Company website. */
+  company_url: string;
+  /** False skips fetching the company's own site. */
+  include_scraping?: boolean;
+  /** Ceiling on sources checked. Cost scales with it. */
+  max_sources?: number;
+  /** How far to go. Deeper costs more. */
+  research_depth?: string | null;
+  /** Narrow the research to these areas. */
+  specific_areas?: Array<string> | null;
+}
+
+export interface Body_research_org_chart_voice_research_org_chart_post {
+  /** Company to research. */
+  company_name: string;
+  /** Company website. */
+  company_url?: string | null;
+  /** Company domain, e.g. `graph8.com`. */
+  domain?: string | null;
+  /** False omits emails and phone numbers, which is the expensive part. */
+  include_contact_info?: boolean;
+  /** "basic", "standard" or "deep". Deeper costs more. */
+  research_depth?: string | null;
+}
+
+export interface Body_store_campaign_memory_voice_campaigns_memory_post {
+  /** The contact this happened with. */
+  contact_id: number;
+  /** What happened, in prose. */
+  content: string;
+}
+
+export interface Body_update_agent_memory_voice_agents__agent_id__memory_post {
+  /** Who the human side was. */
+  actor?: string | null;
+  /** Who the conversation was with. */
+  contact_id: string;
+  /** Channel: "chat", "email", "phone_call", ... */
+  interaction_type?: string;
+  /** Ordered messages, each `{"role": "user"|"assistant", "content": "..."}`. Oldest first. */
+  interactions: Array<unknown>;
+  /** Groups messages into one conversation. Generated when omitted. */
+  session_id?: string | null;
+}
+
+/**
+ * Create or REPLACE the business-hours / after-hours pair for a number.
+ *
+ * This is a two-rule bulk setup, not an addition: calling it again replaces
+ * both rules rather than adding more.
+ */
+export interface BusinessHoursScheduleRequest {
+  after_hours_target: BusinessHoursTargetRef;
+  business_hours: BusinessHoursWindow;
+  business_hours_target: BusinessHoursTargetRef;
+  phone_number: string;
+  /** IANA name (e.g. `America/New_York`). Voice rejects anything pytz cannot load. */
+  timezone: string;
+}
+
+/** Where a call goes in one half of the schedule. */
+export interface BusinessHoursTargetRef {
+  target_id?: string | null;
+  target_type: "ai_agent" | "department" | "extension" | "voicemail";
+}
+
+/** The open hours themselves. */
+export interface BusinessHoursWindow {
+  days: Array<"mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun">;
+  /** 24h HH:MM. */
+  end_time: string;
+  /** 24h HH:MM. */
+  start_time: string;
+}
+
+/**
+ * AI grading for a single dialer call.
+ *
+ * The ``status`` field flips to ``"pending"`` when the upstream service
+ * returns 204 (grading still being computed). In that case ``grading``
+ * will be empty and ``reviewed`` will be ``False``. Callers can poll
+ * until ``status == "ready"``.
+ */
+export interface CallGradingResponse {
+  grading?: Record<string, unknown> | null;
+  reviewed?: boolean;
+  reviewed_at?: string | null;
+  room_name: string;
+  /** ready | pending */
+  status?: string;
+}
+
+/** voice `CallScriptGenerateRequest`, without `org_id` / `agent_settings`. */
+export interface CallScriptGenerate {
+  /** The agent whose persona and knowledge shape the script. */
+  agent_id: string;
+  /** What the call should achieve. */
+  call_objective?: string | null;
+  /** professional, casual, cold_call, follow_up, demo or closing. */
+  call_type?: string;
+  /** What you know about the prospect's company. */
+  company_context?: string | null;
+  /** The contact the call is for; drives memory retrieval. */
+  contact_id: string;
+  /** What the call is about. */
+  context: string;
+  /** openai: gpt-4o or gpt-4o-mini. anthropic: claude-sonnet-4-6, claude-haiku-4-5-20251001 or claude-opus-4-6. Voice rejects any other pairing with a 422. */
+  model?: string;
+  /** Summary of earlier conversations. */
+  previous_interactions?: string | null;
+  /** What you know about the prospect. */
+  prospect_info?: string | null;
+  /** LLM provider. */
+  provider?: "openai" | "anthropic" | "openrouter";
+}
+
+/**
+ * Light-weight dialer call summary returned in the dialer-call list.
+ *
+ * Deliberately omits the transcript blob - transcripts are 5-50 KB each
+ * and including them in a list would blow caller context budget. Use
+ * ``has_transcript`` to decide whether a follow-up GET to
+ * ``/voice/dialer/calls/{room_name}/transcript`` is worthwhile.
+ *
+ * ``contact_id``, ``from_``, and ``to`` are included so client-side
+ * polling consumers (SDR ingestion pipelines) can filter without an
+ * extra round-trip for each row.
+ */
+export interface CallSummaryRow {
+  call_duration?: number | null;
+  contact_id?: string | null;
+  created_at?: unknown | null;
+  disposition?: string | null;
+  from_?: string | null;
+  has_transcript?: boolean;
+  parallel_session_id?: string | null;
+  recording_url?: string | null;
+  room_name: string;
+  summary?: string | null;
+  to?: string | null;
+}
+
+/**
+ * Full transcript payload for a single dialer call.
+ *
+ * Mirrors the grading response shape: ``status="ready"`` when the
+ * transcript has been flushed to the database, ``status="empty"`` when
+ * the call row exists but the persistor has not yet written the
+ * transcript column (the call may still be in progress or the flush
+ * may be in-flight). 404 is raised by the route on a missing row.
+ */
+export interface CallTranscriptResponse {
+  call_duration?: number | null;
+  contact_id?: string | null;
+  created_at?: unknown | null;
+  disposition?: string | null;
+  parallel_session_id?: string | null;
+  recording_url?: string | null;
+  room_name: string;
+  /** ready | empty */
+  status?: string;
+  summary?: string | null;
+  transcript?: Array<CallTranscriptSegment>;
+}
+
+/**
+ * One speaker turn in a persisted dialer transcript.
+ *
+ * ``speaker`` is one of ``SDR | AI | HUMAN | BOT`` (voice service does
+ * not gate the value, so consumers should treat unknown values as
+ * pass-through rather than rejecting the row). ``timestamp`` is the
+ * voice-service-emitted ISO-8601 string and may be missing on very
+ * early rows that pre-date timestamping in dialer_events.py.
+ */
+export interface CallTranscriptSegment {
+  content?: string | null;
+  speaker?: string | null;
+  timestamp?: string | null;
+}
+
+/**
+ * List wrapper for dialer call history.
+ *
+ * Used by ``GET /voice/dialer/calls`` for ALL filter variants
+ * (contact_id, user_email, parallel_session_id, created_after). Echoes
+ * the applied filter values back so callers can sanity-check what the
+ * server actually applied (the proxy may pin org_id, normalize CRM
+ * overlay IDs, etc).
+ */
+export interface CallsListResponse {
+  calls?: Array<CallSummaryRow>;
+  contact_id?: string | null;
+  count?: number;
+  parallel_session_id?: string | null;
+  user_email?: string | null;
+}
+
+/** A new knowledge collection. Bounds mirror voice's own `Query` limits. */
+export interface CollectionCreateRequest {
+  /** What this collection holds. */
+  description?: string | null;
+  /** Collection name. */
+  name: string;
+}
+
+/**
+ * The folder to create. Voice binds `folder_path` as a query parameter;
+ * it is a body field here so a path with slashes needs no URL escaping.
+ */
+export interface CollectionFolder {
+  /** e.g. `pricing/2026`. */
+  folder_path: string;
+}
+
+/**
+ * `POST .../files/paste-text` binds its body as FORM fields (`org_id`,
+ * `folder_path`, `filename`, `text_content`); this is the JSON shape the API
+ * takes, with `org_id` injected from the key.
+ */
+export interface CollectionPasteText {
+  /** Given no extension, `.txt` is appended. */
+  filename: string;
+  /** Folder inside the collection. Empty is the root. */
+  folder_path?: string;
+  text_content: string;
+}
+
+/** voice `CollectionSearchRequest`, without `org_id`. */
+export interface CollectionSearch {
+  /** Collections to search (1-4 is best). */
+  collection_ids: Array<number>;
+  query: string;
+  /** Results per collection. */
+  top_k?: number;
+}
+
+/** Rename or re-describe a collection. Omit a field to leave it alone. */
+export interface CollectionUpdateRequest {
+  description?: string | null;
+  name?: string | null;
+}
+
+/**
+ * One row from the agents list.
+ *
+ * Trimmed to the fields a chat picker needs (name, role, status, and the
+ * UUID to feed back into ``create_dialer_session``). Anything else the
+ * voice service returns (knowledge collections, voice/calendar) stays
+ * server-side - the chat layer doesn't need it for the picker UX.
+ */
+export interface DialerAgentSummary {
+  /** Agent UUID - feed this into create_dialer_session. */
+  agent_id: string;
+  agent_name?: string | null;
+  agent_status?: string | null;
+  description?: string | null;
+  entity_type?: string | null;
+  is_template?: boolean;
+  phone?: string | null;
+  role?: string | null;
+}
+
+/** List wrapper for the agents picker. */
+export interface DialerAgentsListResponse {
+  agents?: Array<DialerAgentSummary>;
+  total_count?: number;
+}
+
+/** One available dialer number with its current health stats. */
+export interface DialerNumberInfo {
+  assigned_to?: string | null;
+  calls_7d?: number;
+  calls_today?: number;
+  connect_rate_7d?: number;
+  created_at?: string | null;
+  daily_limit?: number;
+  inbound_type?: string;
+  is_valid?: boolean;
+  number: string;
+  telephony_provider?: string;
+}
+
+/**
+ * List wrapper for dialer numbers.
+ *
+ * The voice payload includes a top-level ``daily_limit`` default; we
+ * drop it from the public shape because it is per-number on each row
+ * already, so re-publishing it would just confuse callers.
+ */
+export interface DialerNumbersListResponse {
+  numbers?: Array<DialerNumberInfo>;
+}
+
+/**
+ * Echo of the filters the voice service ran the report with.
+ *
+ * Useful for clients that need to confirm which slice they got back,
+ * especially when the request omits ``date_from`` / ``date_to`` and the
+ * server applies defaults.
+ */
+export interface DialerReportFilters {
+  aggregation?: string | null;
+  date_from?: unknown | null;
+  date_to?: unknown | null;
+  org_id?: string | null;
+  session_id?: string | null;
+  user_email?: string | null;
+}
+
+/**
+ * One aggregated row in the analytics report.
+ *
+ * Schema mirrors ``ParallelDialerMetrics``. The disposition breakdown
+ * is a passthrough dict so that voice-side disposition additions do
+ * not require a coordinated DTO bump here.
+ */
+export interface DialerReportMetric {
+  avg_call_duration_minutes?: number;
+  avg_calls_per_session?: number;
+  connection_rate?: number;
+  date?: string | null;
+  dispositions?: Record<string, unknown> | null;
+  list_title?: string | null;
+  org_id?: string | null;
+  peak_calling_hour?: number | null;
+  redial_count?: number;
+  redial_success_rate?: number | null;
+  sdr_name?: string | null;
+  success_rate?: number;
+  talk_time_minutes?: number;
+  total_callbacks?: number;
+  total_connections?: number;
+  total_dials?: number;
+  total_voicemails?: number;
+  unique_sessions?: number;
+  voicemail_rate?: number;
+}
+
+/**
+ * Body for creating a parallel-dialer session in PAUSED state.
+ *
+ * The session is created paused so the SDR can open the dialer UI and
+ * start dialing on their own time. Org and user are pinned server-side
+ * from the API key - any value supplied here is ignored.
+ *
+ * Required: ``name``, ``from_phone``.
+ * Optional: ``list_id`` / ``list_title`` (carried in session metadata),
+ * ``agent_id`` (V2 agent UUID - use ``GET /voice/dialer/agents`` to look up),
+ * ``studio_campaign_id`` (Campaign Builder UUID for studio campaign linkage).
+ */
+export interface DialerSessionCreateRequest {
+  /** Voice agent UUID. Use GET /voice/dialer/agents to look up. */
+  agent_id?: string | null;
+  /** Legacy V1 agent name fallback (defaults to "default_agent" upstream). */
+  agent_name?: string | null;
+  /** Override the session's dialing mode. None keeps voice's default ('power'). Same bug-fix note as parallel_count above - now forwarded instead of dropped. */
+  dialing_mode?: ("power" | "parallel") | null;
+  /** V2 agent entity type ("agent" or "twin"). Optional. */
+  entity_type?: string | null;
+  /** Caller-ID phone number. Must be one of the org's dialer numbers. */
+  from_phone: string;
+  /** Contact list ID the SDR will dial from. Stored in session metadata. */
+  list_id?: string | null;
+  /** Display title for the list (e.g. 'Q4 ICP'). Stored in metadata. */
+  list_title?: string | null;
+  /** Session display name. */
+  name: string;
+  /** Legs to dial per batch once the SDR opens the dialer UI (1 = power mode, 2-5 = parallel). None keeps voice's own default (2). Bug fix (graph8-com/g8 dev-API voice parity): this field previously had no effect - it was accepted by neither this DTO nor the upstream call, so any value a caller sent was silently dropped rather than forwarded. */
+  parallel_count?: number | null;
+  /** Per-session override for voicemail-skip behaviour. None = use SDR default. */
+  skip_voicemails?: boolean | null;
+  /** Campaign Builder (Studio) campaign UUID. Optional linkage. */
+  studio_campaign_id?: string | null;
+  /** IANA timezone for analytics grouping (e.g. "America/New_York"). */
+  user_timezone?: string | null;
+}
+
+/**
+ * Echo of the voice service's ``ParallelDialResponse`` for a paused-create.
+ *
+ * We deliberately drop ``twilio_token`` from the public shape - it is
+ * SDR-frontend-specific and is regenerated by the dialer UI on join, so
+ * re-publishing it here would only confuse a chat caller.
+ */
+export interface DialerSessionCreateResponse {
+  created_at?: unknown | null;
+  from_phone?: string | null;
+  message?: string | null;
+  name?: string | null;
+  org_id?: string | null;
+  session_id: string;
+  session_metadata?: Record<string, unknown> | null;
+  status: string;
+  total_calls?: number;
+  user_email?: string | null;
+  user_id?: string | null;
+}
+
+/**
+ * Body for resuming a paused parallel-dialer session.
+ *
+ * The resume endpoint mirrors what the dialer UI does when the SDR
+ * clicks "Start Dialing" on a paused session: it pages the source list
+ * using the cursor stored in ``session_metadata``, filters out
+ * already-called contacts, and forwards the next batch to the voice
+ * service's ``start-session`` endpoint.
+ *
+ * Only ``max_contacts`` is exposed - org / user / from_phone /
+ * list_id / agent / session_metadata are all read off the persisted
+ * session so the caller doesn't have to reconstruct them.
+ */
+export interface DialerSessionResumeRequest {
+  /** Number of contacts to dial in this batch. Voice caps parallel dialing at 4. */
+  max_contacts?: number;
+}
+
+/**
+ * Echo of voice's ``ParallelDialResponse`` plus a count of contacts dialed.
+ *
+ * ``dialed_count`` is the number of calls actually placed in this
+ * resume batch. It can be lower than ``max_contacts`` when the list is
+ * near exhausted, every remaining row is missing a phone, or every
+ * candidate was already called earlier in the session.
+ *
+ * ``twilio_token`` and ``conference_name`` are deliberately dropped -
+ * they are SDR-frontend specific and an MCP / API caller has no use
+ * for them. The dialer UI regenerates them on join.
+ */
+export interface DialerSessionResumeResponse {
+  created_at?: unknown | null;
+  dialed_count?: number;
+  from_phone?: string | null;
+  message?: string | null;
+  name?: string | null;
+  org_id?: string | null;
+  session_id: string;
+  session_metadata?: Record<string, unknown> | null;
+  status: string;
+  total_calls?: number;
+  updated_at?: unknown | null;
+  user_email?: string | null;
+  user_id?: string | null;
+}
+
+/**
+ * Body for pause / resume / stop on a parallel-dialer session.
+ *
+ * The voice service treats a status PATCH as the lifecycle hook:
+ * - ``ACTIVE`` resumes a paused session.
+ * - ``PAUSED`` pauses an active session.
+ * - ``COMPLETED`` ends the session - one-way, can be re-opened only via
+ *   ``manual-dial`` (which we do not expose here).
+ * - ``FAILED`` is reserved for system use; we reject it on the public
+ *   surface so a caller cannot mis-mark a session.
+ */
+export interface DialerSessionStatusUpdateRequest {
+  /** One of "ACTIVE" (resume), "PAUSED" (pause), "COMPLETED" (stop). */
+  status: string;
+}
+
+/** Echo of voice's ``SessionUpdateResponse`` for the public surface. */
+export interface DialerSessionStatusUpdateResponse {
+  created_at?: unknown | null;
+  from_phone?: string | null;
+  message?: string | null;
+  name?: string | null;
+  org_id?: string | null;
+  session_id: string;
+  session_metadata?: Record<string, unknown> | null;
+  status: string;
+  total_calls?: number;
+  updated_at?: unknown | null;
+  user_email?: string | null;
+  user_id?: string | null;
+}
+
+/**
+ * One row from the dialer-sessions list.
+ *
+ * The voice service returns a flat dict per session built from
+ * ``ParallelDialSession`` columns plus an aggregated ``contact_ids``
+ * array. We surface every documented column directly so that read-only
+ * consumers can introspect a session without a follow-up call.
+ */
+export interface DialerSessionSummary {
+  campaign_builder_campaign_id?: string | null;
+  campaign_id?: string | null;
+  contact_ids?: Array<unknown>;
+  created_at?: unknown | null;
+  from_phone?: string | null;
+  name?: string | null;
+  org_id?: string | null;
+  session_id: string;
+  session_metadata?: Record<string, unknown> | null;
+  status?: string | null;
+  total_calls?: number | null;
+  updated_at?: unknown | null;
+  user_email?: string | null;
+  user_id?: string | null;
+}
+
+/**
+ * List wrapper for dialer sessions.
+ *
+ * Top-level matches the voice payload (``data`` + ``pagination``) so the
+ * public API caller sees the exact same shape they would get if voice
+ * were exposed directly. The standard ``ApiResponse`` envelope wraps
+ * THIS object as its ``data`` field.
+ */
+export interface DialerSessionsListResponse {
+  pagination?: VoicePagination;
+  sessions?: Array<DialerSessionSummary>;
+}
+
+/** voice `DialerSettingsRequest`, without `org_id`. Only fields sent change. */
+export interface DialerSettingsUpdate {
+  dialing_mode?: ("power" | "parallel") | null;
+  dnd_enabled?: boolean | null;
+  parallel_count?: number | null;
+  skip_dial_trees?: boolean | null;
+  skip_voicemails?: boolean | null;
+  /** The rep whose settings these are. */
+  user_email: string;
+  voicemail_grace_period?: number | null;
+}
+
+/**
+ * Top-level wrapper for dialer analytics.
+ *
+ * Field names follow the voice ``ParallelDialerReport`` shape so the
+ * structured response is meaningful both to a Developer API caller and
+ * to an MCP agent rendering it inline.
+ */
+export interface DialerStatsResponse {
+  filters?: DialerReportFilters;
+  metrics?: Array<DialerReportMetric>;
+  summary?: DialerReportMetric | null;
+}
+
+/** voice `EmailThread`: one earlier message in the thread being answered. */
+export interface EmailThreadMessage {
+  body: string;
+  sender?: string | null;
+  subject: string;
+  timestamp?: string | null;
+}
+
+/**
+ * A rule deciding where an inbound call on one number goes.
+ *
+ * `org_id` is absent on purpose - pinned from the key by the router.
+ * Rules are evaluated by ascending `priority`; the first whose
+ * `match_conditions` hold wins.
+ */
+export interface InboundRouteCreateRequest {
+  is_active?: boolean;
+  /** `{"always": true}` or a `{"schedule": {...}}` block with `days`, `start_time`/`end_time` as HH:MM, and an IANA `timezone`. */
+  match_conditions?: Record<string, unknown>;
+  name?: string | null;
+  /** The number this rule applies to. */
+  phone_number: string;
+  /** Lower wins. Ties are resolved arbitrarily. */
+  priority?: number;
+  queue_max_wait_seconds?: number | null;
+  ring_strategy?: "single" | "round_robin";
+  /** Agent id, department or extension - depends on `target_type`. */
+  target_id?: string | null;
+  target_type: "ai_agent" | "department" | "extension" | "voicemail";
+}
+
+/** Partial update of one rule. Omitted fields are untouched. */
+export interface InboundRouteUpdateRequest {
+  is_active?: boolean | null;
+  match_conditions?: Record<string, unknown> | null;
+  name?: string | null;
+  priority?: number | null;
+  queue_max_wait_seconds?: number | null;
+  ring_strategy?: ("single" | "round_robin") | null;
+  target_id?: string | null;
+  target_type?: ("ai_agent" | "department" | "extension" | "voicemail") | null;
+}
+
+/**
+ * An MCP server an agent can call tools on.
+ *
+ * `org_id` is deliberately ABSENT even though voice's model requires it: it
+ * is pinned from the API key by the router and a body-supplied value would be
+ * a tenancy hole.
+ */
+export interface McpServerCreateRequest {
+  args?: Array<string> | null;
+  /** Required when `transport_type` is `stdio`. */
+  command?: string | null;
+  /** Required when `transport_type` is `sse`. */
+  connection_url?: string | null;
+  description?: string | null;
+  enabled?: boolean;
+  /** Environment for the server process. WRITE-ONLY: values set here are never echoed back by the read routes. */
+  env_vars?: Record<string, string> | null;
+  name: string;
+  /** `sse` for a remote server reached over HTTP, `stdio` for a local process. */
+  transport_type: "sse" | "stdio";
+}
+
+/** Partial update. Every field is optional; omitted fields are untouched. */
+export interface McpServerUpdateRequest {
+  args?: Array<string> | null;
+  command?: string | null;
+  connection_url?: string | null;
+  description?: string | null;
+  enabled?: boolean | null;
+  env_vars?: Record<string, string> | null;
+  name?: string | null;
+  transport_type?: ("sse" | "stdio") | null;
+}
+
+/** One missed inbound callback row. */
+export interface MissedCallback {
+  call_duration?: number | null;
+  caller_phone?: string | null;
+  contact_id?: unknown | null;
+  created_at?: unknown | null;
+  email?: string | null;
+  first_name?: string | null;
+  id?: unknown | null;
+  inbound_number?: string | null;
+  is_callback?: boolean;
+  last_disposition?: string | null;
+  last_name?: string | null;
+  missed_reason?: string | null;
+  parallel_session_id?: string | null;
+  previous_calls_count?: number;
+  resolution?: string | null;
+  resolved_at?: unknown | null;
+  resolved_by?: string | null;
+  seen_at?: unknown | null;
+  seen_by?: string | null;
+  session?: MissedCallbackSession | null;
+}
+
+/** Parallel session the caller was previously dialed from. */
+export interface MissedCallbackSession {
+  campaign_id?: string | null;
+  list_id?: string | null;
+  list_title?: string | null;
+  name?: string | null;
+  session_id?: string | null;
+  status?: string | null;
+}
+
+export interface MissedCallbacksResponse {
+  count?: number;
+  missed_callbacks?: Array<MissedCallback>;
+}
+
+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;
+}
+
+/**
+ * A colleague the receptionist and the in-call transfer picker can reach.
+ *
+ * `extension` and `phone_number` are both optional: the number a transfer
+ * actually dials is resolved from the work-number inventory first, and the
+ * stored `phone_number` is only the hand-entered override.
+ */
+export interface PhoneDirectoryEntryCreate {
+  availability?: string;
+  department: string;
+  extension?: string | null;
+  is_active?: boolean;
+  phone_number?: string | null;
+  user_email: string;
+  user_name: string;
+}
+
+export interface PhoneDirectoryEntryUpdate {
+  availability?: string | null;
+  department?: string | null;
+  extension?: string | null;
+  is_active?: boolean | null;
+  phone_number?: string | null;
+  user_name?: string | null;
+}
+
+/**
+ * A site to crawl into a collection on a schedule.
+ *
+ * CREATING ONE CRAWLS IMMEDIATELY - it does not wait for the first scheduled
+ * run. That is why this operation is `billable` rather than a plain write.
+ */
+export interface ScrapeSourceCreateRequest {
+  /** How often to re-crawl. `manual` never re-crawls. */
+  frequency?: "daily" | "weekly" | "monthly" | "manual";
+  /** Ceiling, not a target - a small site only crawls what exists. */
+  max_pages?: number;
+  /** Root URL. Everything under it is followed. */
+  url: string;
+}
+
+/** Change a source's cadence, page ceiling, or pause it. Omitted = unchanged. */
+export interface ScrapeSourceUpdateRequest {
+  /** False pauses the recurring crawl; the source survives. */
+  enabled?: boolean | null;
+  frequency?: ("daily" | "weekly" | "monthly" | "manual") | null;
+  max_pages?: number | null;
+}
+
+/** voice `SessionCallsRequest`. */
+export interface SessionCallsLookup {
+  contact_ids: Array<string>;
+}
+
+/**
+ * `POST /api/v1/twins/extract-linkedin` binds `linkedin_url` as a FORM
+ * field; this is the JSON shape the API takes and the router re-encodes.
+ */
+export interface TwinLinkedInExtract {
+  /** A LinkedIn profile URL, e.g. https://linkedin.com/in/name */
+  linkedin_url: string;
+}
+
+/**
+ * Body for creating a voice agent or twin.
+ *
+ * Org is pinned server-side from the API key - never read from the body.
+ * ``created_by_email`` is likewise pinned to the calling principal (used
+ * upstream for one-twin-per-user enforcement and SDR/booking attribution);
+ * an org-wide API key has no per-human identity to attribute to beyond the
+ * key itself, so it is set to the same identifier the dialer-session and
+ * call routes already use for ``user_email``.
+ *
+ * Deliberately NOT exposed here (follow-up, not an oversight): twin-only
+ * fields ``tone_profile``, ``channels``, and ``persona_source_user_id``.
+ * They only apply when ``entity_type="twin"`` and none of this PR's
+ * priority surfaces (ad-hoc call, dialer sessions, dispositions) need them.
+ */
+export interface VoiceAgentCreateRequest {
+  /** Agent UUID. Auto-generated if omitted. */
+  agent_id?: string | null;
+  /** Initial status. */
+  agent_status?: "active" | "inactive" | "archived";
+  /** "agent" or "twin". */
+  entity_type?: "agent" | "twin";
+  identity: VoiceAgentIdentity;
+  /** Save this as a reusable template rather than a live agent. */
+  is_template?: boolean;
+  /** Attached knowledge collections. */
+  knowledge?: VoiceAgentKnowledge | null;
+  persona: VoiceAgentPersona;
+  /** Agent role (e.g. "SDR", "AE", "Receptionist", "CSM"). */
+  role: string;
+  /** Template this agent was cloned from, if any. */
+  template_id?: string | null;
+  /** Also draw on the org-wide knowledge base. */
+  use_company_knowledge?: boolean;
+}
+
+/** Complete agent configuration, as returned by create/get/update. */
+export interface VoiceAgentDetail {
+  agent_id: string;
+  agent_status: string;
+  created_at?: unknown | null;
+  created_by_email?: string | null;
+  entity_type: string;
+  id: number;
+  identity: VoiceAgentIdentity;
+  is_template: boolean;
+  knowledge: VoiceAgentKnowledge;
+  org_id: string;
+  persona: VoiceAgentPersona;
+  role: string;
+  template_id?: string | null;
+  updated_at?: unknown | null;
+  use_company_knowledge: boolean;
+}
+
+/** Communication-channel identity for a voice agent (mirrors V2 ``IdentityV2``). */
+export interface VoiceAgentIdentity {
+  /** URL of the agent's avatar image. Optional. */
+  avatar_url?: string | null;
+  /** Calendar/event-type system ID. Optional. */
+  calendar?: number | null;
+  /** Phone number in E.164 format (e.g. +15551234567). Optional. */
+  phone?: string | null;
+  /** Voice ID (Cartesia voice_id or OpenAI voice name). Optional. */
+  voice?: string | null;
+}
+
+/** Knowledge-collection attachments for a voice agent. */
+export interface VoiceAgentKnowledge {
+  /** Collection IDs (max 4). */
+  collections?: Array<string>;
+}
+
+/** Paginated agent list. */
+export interface VoiceAgentListResponse {
+  agents?: Array<VoiceAgentSummary>;
+  page?: number;
+  page_size?: number;
+  total_count?: number;
+  total_pages?: number;
+}
+
+/** Persona / prompt configuration for a voice agent (mirrors V2 ``PersonaV2``). */
+export interface VoiceAgentPersona {
+  /** Display name of the agent. */
+  agent_name: string;
+  /** 0.0=passive, 1.0=assertive. */
+  assertiveness_level: number;
+  /** TTS pronunciation override for the company name (e.g. 'Science' for 'CIENCE'). */
+  company_name_pronunciation?: string | null;
+  /** 0.0=verbose, 1.0=brief. */
+  conciseness_level: number;
+  /** Brief summary of the agent's purpose. */
+  description: string;
+  /** 0.0=casual, 1.0=formal. */
+  formality_level: number;
+  /** Extra instructions for inbound calls. */
+  inbound_instructions?: string | null;
+  /** Extra instructions for outbound calls. */
+  outbound_instructions?: string | null;
+  /** Voicemail message this agent leaves. */
+  outbound_voicemail_prompt?: string | null;
+  /** Personality and behavior description. */
+  persona: string;
+}
+
+/** Envelope for single-agent operations (create / get / update). */
+export interface VoiceAgentResponse {
+  agent?: VoiceAgentDetail | null;
+  message?: string | null;
+}
+
+/**
+ * One row from the agent list (full management shape - see also the
+ * lighter-weight ``DialerAgentSummary`` used by the dialer picker).
+ */
+export interface VoiceAgentSummary {
+  agent_id: string;
+  agent_name: string;
+  agent_status: string;
+  avatar_url?: string | null;
+  calendar_event_id?: number | null;
+  collection_count?: number;
+  created_at?: unknown | null;
+  description?: string | null;
+  entity_type: string;
+  has_knowledge?: boolean;
+  id: number;
+  is_template?: boolean;
+  org_id: string;
+  phone?: string | null;
+  role: string;
+  template_id?: string | null;
+  updated_at?: unknown | null;
+  use_company_knowledge?: boolean;
+  voice?: string | null;
+}
+
+/** Body for partially updating a voice agent. Only supplied fields change. */
+export interface VoiceAgentUpdateRequest {
+  agent_status?: ("active" | "inactive" | "archived") | null;
+  identity?: VoiceAgentIdentity | null;
+  is_template?: boolean | null;
+  knowledge?: VoiceAgentKnowledge | null;
+  persona?: VoiceAgentPersona | null;
+  role?: string | null;
+  use_company_knowledge?: boolean | null;
+}
+
+/**
+ * Body for dispatching one AI-agent call to an arbitrary number.
+ *
+ * No dialer session or contact list required - this is the "call this one
+ * number right now" primitive (`voice/graph8_livekit/routers/call.py:19`).
+ * Places a REAL call and is billable; send an ``Idempotency-Key`` header to
+ * make a retry safe (honored automatically by the Developer API's
+ * idempotency middleware on every POST - no extra body field needed).
+ */
+export interface VoiceCallStartRequest {
+  /** Voice agent UUID. Use GET /voice/agents to look up. */
+  agent_id?: string | null;
+  /** Legacy V1 agent-name fallback. */
+  agent_name?: string | null;
+  /** Webhook notified with the call result on completion. Optional. */
+  callback_url?: string | null;
+  /** Optional campaign id for attribution. */
+  campaign_id?: string | null;
+  /** CDP contact id, if this call is tied to a known contact. */
+  contact_id?: string | null;
+  /** If true, the call is validated but not actually dispatched. */
+  dry_run?: boolean;
+  /** Contact email, for the agent's context. */
+  email?: string | null;
+  /** "agent" or "twin". Optional. */
+  entity_type?: ("agent" | "twin") | null;
+  /** Appointments event-type id the agent can offer to book. Omit if this call has no booking flow. */
+  event_id?: number | null;
+  /** Contact first name, for the agent's context. */
+  first_name?: string | null;
+  /** Caller ID. Must be one of the org's numbers. */
+  from_phone: string;
+  /** Contact last name, for the agent's context. */
+  last_name?: string | null;
+  /** Optional Campaign Builder (Studio) campaign UUID. */
+  studio_campaign_id?: string | null;
+  /** IANA timezone for the callee. */
+  timezone?: string;
+  /** Number to call. Normalized server-side. */
+  to_phone: string;
+}
+
+/** Echo of voice's ``AgentDispatchResponse``. */
+export interface VoiceCallStartResponse {
+  message: string;
+  room_name: string;
+  status: string;
+}
+
+/**
+ * Body for creating an org-level custom disposition. Org admin only
+ * (enforced by voice; see the router docstring above).
+ */
+export interface VoiceCustomDispositionCreateRequest {
+  /** Hex value from voice's preset palette (e.g. '#10b981'). Invalid values 400. */
+  color: string;
+  description?: string | null;
+  /** Whether this outcome counts as a live connection in analytics. */
+  is_connected: boolean;
+  name: string;
+}
+
+export interface VoiceCustomDispositionItem {
+  color: string;
+  description?: string | null;
+  id: number;
+  is_connected: boolean;
+  /** Stable value to use in filters/writes, e.g. "custom_42". */
+  key: string;
+  name: string;
+}
+
+/**
+ * Body for editing a custom disposition. Only supplied fields change.
+ *
+ * ``is_connected`` is locked by voice once any call already references the
+ * disposition (changing it would retroactively re-classify historical
+ * calls) - forwarded as-is and voice's 409 surfaces to the caller.
+ */
+export interface VoiceCustomDispositionUpdateRequest {
+  color?: string | null;
+  description?: string | null;
+  is_connected?: boolean | null;
+  name?: string | null;
+}
+
+export interface VoiceDispositionListResponse {
+  custom?: Array<VoiceCustomDispositionItem>;
+  custom_limit?: number;
+  custom_used?: number;
+  system?: Array<VoiceSystemDispositionItem>;
+}
+
+/**
+ * A LIST result from voice, normalised so `items` is always present.
+ *
+ * Voice is inconsistent about whether a list comes back bare or under a named
+ * key (`collections`, `files`, `routes`, `chats`, ...). Both are preserved:
+ * the original key is kept for anyone reading voice's docs, and `items`
+ * always holds the same rows so a client can page one way.
+ */
+export interface VoiceListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * Pagination block returned by the voice list-sessions endpoint.
+ *
+ * Mirrored verbatim so the field names match what voice already ships
+ * (``total_items`` / ``total_pages`` / ``current_page`` / ``page_size``).
+ * Keeping voice's field names here avoids a renaming layer that would
+ * have to be updated every time voice extends the block.
+ */
+export interface VoicePagination {
+  current_page?: number;
+  page_size?: number;
+  total_items?: number;
+  total_pages?: number;
+}
+
+/**
+ * One voice object - a collection, an agent, a route, a chat.
+ *
+ * Open-shaped: voice adds fields to these bodies on its own release cadence
+ * and a dropped-or-added key must not be a 500 in this service.
+ */
+export type VoicePayload = Record<string, unknown>;
+
+export interface VoiceSystemDispositionItem {
+  is_connected: boolean;
+  key: string;
+}