retell-sdk 5.62.0 → 5.64.0

package/src/resources/conversation-flow-component.ts

@@ -2141,7 +2141,9 @@ export namespace ConversationFlowComponentResponse {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -6641,7 +6643,9 @@ export namespace ConversationFlowComponentResponse {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 
@@ -10790,7 +10794,9 @@ export namespace ConversationFlowComponentCreateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -15290,7 +15296,9 @@ export namespace ConversationFlowComponentCreateParams {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 
@@ -19459,7 +19467,9 @@ export namespace ConversationFlowComponentUpdateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -23959,7 +23969,9 @@ export namespace ConversationFlowComponentUpdateParams {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 

package/src/resources/conversation-flow.ts

@@ -103,8 +103,14 @@ export class ConversationFlow extends APIResource {
    * );
    * ```
    */
-  delete(conversationFlowID: string, options?: RequestOptions): APIPromise<void> {
+  delete(
+    conversationFlowID: string,
+    params: ConversationFlowDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { force_delete } = params ?? {};
     return this._client.delete(path`/delete-conversation-flow/${conversationFlowID}`, {
+      query: { force_delete },
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -2271,7 +2277,9 @@ export namespace ConversationFlowResponse {
         keep_current_language?: boolean;
 
         /**
-         * If true, keep the current voice when swapping agents. Defaults to false.
+         * If true, keep the current voice and ambient sound settings when swapping agents.
+         * Otherwise, use the destination agent's voice and ambient sound settings.
+         * Defaults to false.
          */
         keep_current_voice?: boolean;
 
@@ -6771,7 +6779,9 @@ export namespace ConversationFlowResponse {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -10926,7 +10936,9 @@ export namespace ConversationFlowResponse {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -15426,7 +15438,9 @@ export namespace ConversationFlowResponse {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 
@@ -19642,7 +19656,9 @@ export namespace ConversationFlowCreateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -24142,7 +24158,9 @@ export namespace ConversationFlowCreateParams {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 
@@ -27956,7 +27974,9 @@ export namespace ConversationFlowCreateParams {
         keep_current_language?: boolean;
 
         /**
-         * If true, keep the current voice when swapping agents. Defaults to false.
+         * If true, keep the current voice and ambient sound settings when swapping agents.
+         * Otherwise, use the destination agent's voice and ambient sound settings.
+         * Defaults to false.
          */
         keep_current_voice?: boolean;
 
@@ -32456,7 +32476,9 @@ export namespace ConversationFlowCreateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -37068,7 +37090,9 @@ export namespace ConversationFlowUpdateParams {
         keep_current_language?: boolean;
 
         /**
-         * If true, keep the current voice when swapping agents. Defaults to false.
+         * If true, keep the current voice and ambient sound settings when swapping agents.
+         * Otherwise, use the destination agent's voice and ambient sound settings.
+         * Defaults to false.
          */
         keep_current_voice?: boolean;
 
@@ -41568,7 +41592,9 @@ export namespace ConversationFlowUpdateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -45723,7 +45749,9 @@ export namespace ConversationFlowUpdateParams {
       keep_current_language?: boolean;
 
       /**
-       * If true, keep the current voice when swapping agents. Defaults to false.
+       * If true, keep the current voice and ambient sound settings when swapping agents.
+       * Otherwise, use the destination agent's voice and ambient sound settings.
+       * Defaults to false.
        */
       keep_current_voice?: boolean;
 
@@ -50223,7 +50251,9 @@ export namespace ConversationFlowUpdateParams {
     keep_current_language?: boolean;
 
     /**
-     * If true, keep the current voice when swapping agents. Defaults to false.
+     * If true, keep the current voice and ambient sound settings when swapping agents.
+     * Otherwise, use the destination agent's voice and ambient sound settings.
+     * Defaults to false.
      */
     keep_current_voice?: boolean;
 
@@ -52325,6 +52355,15 @@ export interface ConversationFlowListParams {
   sort_order?: 'ascending' | 'descending';
 }
 
+export interface ConversationFlowDeleteParams {
+  /**
+   * By default the deletion is rejected with a 400 if any agent still uses this
+   * conversation flow as its response engine. Set to true to delete it anyway, which
+   * leaves those agents pointing at a conversation flow that no longer exists.
+   */
+  force_delete?: boolean;
+}
+
 export declare namespace ConversationFlow {
   export {
     type ConversationFlowResponse as ConversationFlowResponse,
@@ -52333,5 +52372,6 @@ export declare namespace ConversationFlow {
     type ConversationFlowRetrieveParams as ConversationFlowRetrieveParams,
     type ConversationFlowUpdateParams as ConversationFlowUpdateParams,
     type ConversationFlowListParams as ConversationFlowListParams,
+    type ConversationFlowDeleteParams as ConversationFlowDeleteParams,
   };
 }

package/src/resources/crm.ts

@@ -0,0 +1,293 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class CRM extends APIResource {
+  /**
+   * Get the organization's CRM configuration: which CRM app is linked, the custom
+   * contact fields defined for it, and how post-call analysis data is written back
+   * to contacts. Returns an empty configuration when nothing has been set up yet.
+   */
+  getConfig(options?: RequestOptions): APIPromise<CRMConfig> {
+    return this._client.get('/get-crm-config', options);
+  }
+
+  /**
+   * Get the contact schema of the connected CRM: the fields available on its contact
+   * object, which are the values that sync mappings can reference.
+   */
+  getSchema(
+    query: CRMGetSchemaParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CRMGetSchemaResponse> {
+    return this._client.get('/get-crm-schema', { query, ...options });
+  }
+
+  /**
+   * Get the status of the organization's contact sync, whether it was started
+   * manually or by the schedule. Returns status `idle` when no sync is running.
+   */
+  getSyncJobStatus(options?: RequestOptions): APIPromise<CRMGetSyncJobStatusResponse> {
+    return this._client.get('/get-sync-job-status', options);
+  }
+
+  /**
+   * Start a contact sync with the linked CRM app immediately, instead of waiting for
+   * the scheduled sync. One sync runs per organization at a time: starting another
+   * while one is in flight is rejected. Poll get-sync-job-status for progress.
+   */
+  runSyncJob(options?: RequestOptions): APIPromise<CRMRunSyncJobResponse> {
+    return this._client.post('/run-sync-job', options);
+  }
+
+  /**
+   * Update the organization's CRM configuration. Omitted fields stay as they are; a
+   * field that is sent replaces its stored value in full.
+   */
+  updateConfig(body: CRMUpdateConfigParams, options?: RequestOptions): APIPromise<CRMConfig> {
+    return this._client.post('/update-crm-config', { body, ...options });
+  }
+}
+
+export interface CRMConfig {
+  org_id: string;
+
+  /**
+   * The connected CRM integration app ID.
+   */
+  app_id?: string;
+
+  /**
+   * Preferred display order of contact fields, for clients that render contacts as a
+   * table. Not used by the API itself.
+   */
+  contact_columns_order?: Array<string>;
+
+  crm_analysis_data_mappings?: Array<CRMConfig.CRMAnalysisDataMapping>;
+
+  custom_fields?: Array<CRMConfig.CustomField>;
+
+  /**
+   * Epoch milliseconds of the last successful sync.
+   */
+  last_sync_timestamp?: number;
+}
+
+export namespace CRMConfig {
+  export interface CRMAnalysisDataMapping {
+    /**
+     * Name of the post-call analysis field to read the value from. A value that does
+     * not match the contact field's type is skipped rather than failing the
+     * conversation.
+     */
+    analysis_data_name: string;
+
+    /**
+     * Contact field to write to. Must be an existing built-in or custom contact field,
+     * and cannot be phone_number, which identifies the contact.
+     */
+    field_name: string;
+
+    /**
+     * How to reconcile the new value with what the contact already holds. `overwrite`
+     * always replaces it, `fill_if_empty` writes only when the field is empty, and
+     * `merge` combines the existing text with the new value. `merge` is available on
+     * string fields only.
+     */
+    update_mode: 'overwrite' | 'fill_if_empty' | 'merge';
+  }
+
+  export interface CustomField {
+    name: string;
+
+    type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'enum';
+
+    description?: string;
+
+    /**
+     * Display label for the field.
+     */
+    label?: string;
+
+    /**
+     * Allowed values. Required when `type` is `enum`, where a value is rejected unless
+     * it appears here; ignored for every other type.
+     */
+    options?: Array<string>;
+  }
+}
+
+export interface CRMGetSchemaResponse {
+  fields: Array<CRMGetSchemaResponse.Field>;
+
+  /**
+   * CRM provider name.
+   */
+  provider: string;
+}
+
+export namespace CRMGetSchemaResponse {
+  export interface Field {
+    name: string;
+
+    type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'enum';
+
+    description?: string;
+
+    /**
+     * Display label for the field.
+     */
+    label?: string;
+
+    /**
+     * Allowed values. Required when `type` is `enum`, where a value is rejected unless
+     * it appears here; ignored for every other type.
+     */
+    options?: Array<string>;
+  }
+}
+
+export interface CRMGetSyncJobStatusResponse {
+  status: 'queued' | 'running' | 'idle';
+
+  /**
+   * Number of items that errored so far.
+   */
+  failed?: number;
+
+  /**
+   * Epoch milliseconds when the job started.
+   */
+  start_timestamp?: number;
+
+  /**
+   * Number of items processed successfully so far.
+   */
+  succeeded?: number;
+
+  /**
+   * Whether the job was started by an explicit API call (`manual`) or by the
+   * scheduled sync (`cron`).
+   */
+  triggered_by?: 'manual' | 'cron';
+}
+
+export interface CRMRunSyncJobResponse {
+  status: 'queued' | 'running' | 'idle';
+
+  /**
+   * Number of items that errored so far.
+   */
+  failed?: number;
+
+  /**
+   * Epoch milliseconds when the job started.
+   */
+  start_timestamp?: number;
+
+  /**
+   * Number of items processed successfully so far.
+   */
+  succeeded?: number;
+
+  /**
+   * Whether the job was started by an explicit API call (`manual`) or by the
+   * scheduled sync (`cron`).
+   */
+  triggered_by?: 'manual' | 'cron';
+}
+
+export interface CRMGetSchemaParams {
+  /**
+   * ID of the CRM app to read the schema from. Defaults to the app linked in the
+   * organization's CRM configuration. Naming a different app additionally requires
+   * the App.Read scope.
+   */
+  app_id?: string;
+}
+
+export interface CRMUpdateConfigParams {
+  /**
+   * ID of the CRM app to link. Pass null to unlink, which stops syncing. Changing it
+   * resets the sync cursor, so the next sync re-reads every contact from the new
+   * CRM.
+   */
+  app_id?: string | null;
+
+  /**
+   * Preferred display order of contact fields, for clients that render contacts as a
+   * table. Not used by the API itself.
+   */
+  contact_columns_order?: Array<string>;
+
+  /**
+   * Replaces the stored list.
+   */
+  crm_analysis_data_mappings?: Array<CRMUpdateConfigParams.CRMAnalysisDataMapping>;
+
+  /**
+   * Replaces the stored list. Names must be snake_case and cannot collide with a
+   * built-in contact field or start with `contact`/`external`. Removing a field that
+   * an analysis data mapping still targets is rejected — send
+   * crm_analysis_data_mappings in the same request to retarget or drop those
+   * mappings.
+   */
+  custom_fields?: Array<CRMUpdateConfigParams.CustomField>;
+}
+
+export namespace CRMUpdateConfigParams {
+  export interface CRMAnalysisDataMapping {
+    /**
+     * Name of the post-call analysis field to read the value from. A value that does
+     * not match the contact field's type is skipped rather than failing the
+     * conversation.
+     */
+    analysis_data_name: string;
+
+    /**
+     * Contact field to write to. Must be an existing built-in or custom contact field,
+     * and cannot be phone_number, which identifies the contact.
+     */
+    field_name: string;
+
+    /**
+     * How to reconcile the new value with what the contact already holds. `overwrite`
+     * always replaces it, `fill_if_empty` writes only when the field is empty, and
+     * `merge` combines the existing text with the new value. `merge` is available on
+     * string fields only.
+     */
+    update_mode: 'overwrite' | 'fill_if_empty' | 'merge';
+  }
+
+  export interface CustomField {
+    name: string;
+
+    type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'enum';
+
+    description?: string;
+
+    /**
+     * Display label for the field.
+     */
+    label?: string;
+
+    /**
+     * Allowed values. Required when `type` is `enum`, where a value is rejected unless
+     * it appears here; ignored for every other type.
+     */
+    options?: Array<string>;
+  }
+}
+
+export declare namespace CRM {
+  export {
+    type CRMConfig as CRMConfig,
+    type CRMGetSchemaResponse as CRMGetSchemaResponse,
+    type CRMGetSyncJobStatusResponse as CRMGetSyncJobStatusResponse,
+    type CRMRunSyncJobResponse as CRMRunSyncJobResponse,
+    type CRMGetSchemaParams as CRMGetSchemaParams,
+    type CRMUpdateConfigParams as CRMUpdateConfigParams,
+  };
+}

package/src/resources/index.ts

@@ -6,15 +6,38 @@ export {
   type AgentListResponse,
   type AgentCreateVersionResponse,
   type AgentGetVersionsResponse,
+  type AgentListVersionsResponse,
   type AgentCreateParams,
   type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
   type AgentCreateVersionParams,
   type AgentDeleteVersionParams,
+  type AgentListVersionsParams,
   type AgentPublishParams,
 } from './agent';
+export {
+  App,
+  type AppResponse,
+  type AppListResponse,
+  type AppListUsagesResponse,
+  type AppTestAuthResponse,
+  type AppCreateParams,
+  type AppUpdateParams,
+  type AppListParams,
+  type AppDeleteParams,
+  type AppListUsagesParams,
+} from './app';
 export { BatchCall, type BatchCallResponse, type BatchCallCreateBatchCallParams } from './batch-call';
+export {
+  CRM,
+  type CRMConfig,
+  type CRMGetSchemaResponse,
+  type CRMGetSyncJobStatusResponse,
+  type CRMRunSyncJobResponse,
+  type CRMGetSchemaParams,
+  type CRMUpdateConfigParams,
+} from './crm';
 export {
   Call,
   type CallResponse,
@@ -55,6 +78,19 @@ export {
   type ChatAgentPublishParams,
 } from './chat-agent';
 export { Concurrency, type ConcurrencyRetrieveResponse } from './concurrency';
+export {
+  Contact,
+  type ContactResponse,
+  type ContactListResponse,
+  type ContactBackfillAnalysisDataResponse,
+  type ContactGetBackfillJobStatusResponse,
+  type ContactListConversationsResponse,
+  type ContactCreateParams,
+  type ContactUpdateParams,
+  type ContactListParams,
+  type ContactBackfillAnalysisDataParams,
+  type ContactListConversationsParams,
+} from './contact';
 export {
   ConversationFlow,
   type ConversationFlowResponse,
@@ -63,6 +99,7 @@ export {
   type ConversationFlowRetrieveParams,
   type ConversationFlowUpdateParams,
   type ConversationFlowListParams,
+  type ConversationFlowDeleteParams,
 } from './conversation-flow';
 export {
   ConversationFlowComponent,
@@ -94,6 +131,7 @@ export {
   type LlmRetrieveParams,
   type LlmUpdateParams,
   type LlmListParams,
+  type LlmDeleteParams,
 } from './llm';
 export {
   McpTool,

package/src/resources/knowledge-base.ts

@@ -125,10 +125,18 @@ export interface KnowledgeBaseResponse {
   knowledge_base_name: string;
 
   /**
-   * Status of the knowledge base. When it's created and being processed, it's
-   * "in_progress". When the processing is done, it's "complete". When there's an
-   * error in processing, it's "error". When it is during kb updating, it's
-   * "refreshing_in_progress".
+   * Current processing state of the knowledge base:
+   *
+   * - `in_progress`: Initial indexing is running. Source metadata may be incomplete
+   *   until indexing finishes.
+   * - `complete`: Initial indexing or the latest update or refresh finished.
+   *   Individual source failures may still be reported in `error_messages`.
+   * - `error`: Initial indexing failed. Source metadata may be incomplete.
+   * - `refreshing_in_progress`: An existing knowledge base is being updated. This
+   *   includes indexing newly added sources or running a manual or automatic refresh
+   *   that re-indexes URLs, Google Drive files, and pages from auto-crawling paths.
+   *   Previously indexed sources remain available during the update, and the source
+   *   list may change when it finishes.
    */
   status: 'in_progress' | 'complete' | 'error' | 'refreshing_in_progress';