retell-sdk 4.58.0 → 4.59.0

package/src/resources/call.ts

@@ -1974,7 +1974,8 @@ export interface CallUpdateParams {
    * Override dynamic varaibles represented as key-value pairs of strings. Setting
    * this will override or add the dynamic variables set in the agent during the
    * call. Only need to set the delta where you want to override, no need to set the
-   * entire dynamic variables object.
+   * entire dynamic variables object. Setting this to null will remove any existing
+   * override.
    */
   override_dynamic_variables?: { [key: string]: string } | null;
 }
@@ -2154,8 +2155,9 @@ export interface CallCreatePhoneCallParams {
   to_number: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallCreatePhoneCallParams.AgentOverride;
 
@@ -2202,8 +2204,9 @@ export interface CallCreatePhoneCallParams {
 
 export namespace CallCreatePhoneCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -2215,16 +2218,17 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -2839,8 +2843,8 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -2876,6 +2880,12 @@ export namespace CallCreatePhoneCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -2932,8 +2942,9 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -2980,6 +2991,13 @@ export namespace CallCreatePhoneCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -2999,6 +3017,12 @@ export namespace CallCreatePhoneCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {
@@ -3028,8 +3052,9 @@ export interface CallCreateWebCallParams {
   agent_id: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallCreateWebCallParams.AgentOverride;
 
@@ -3055,8 +3080,9 @@ export interface CallCreateWebCallParams {
 
 export namespace CallCreateWebCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -3068,16 +3094,17 @@ export namespace CallCreateWebCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -3692,8 +3719,8 @@ export namespace CallCreateWebCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -3729,6 +3756,12 @@ export namespace CallCreateWebCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -3785,8 +3818,9 @@ export namespace CallCreateWebCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -3833,6 +3867,13 @@ export namespace CallCreateWebCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -3852,6 +3893,12 @@ export namespace CallCreateWebCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {
@@ -3880,8 +3927,9 @@ export interface CallRegisterPhoneCallParams {
   agent_id: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallRegisterPhoneCallParams.AgentOverride;
 
@@ -3922,8 +3970,9 @@ export interface CallRegisterPhoneCallParams {
 
 export namespace CallRegisterPhoneCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -3935,16 +3984,17 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -4559,8 +4609,8 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -4596,6 +4646,12 @@ export namespace CallRegisterPhoneCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -4652,8 +4708,9 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -4700,6 +4757,13 @@ export namespace CallRegisterPhoneCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -4719,6 +4783,12 @@ export namespace CallRegisterPhoneCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {

package/src/resources/chat.ts

@@ -32,6 +32,34 @@ export class Chat extends APIResource {
     return this._client.get(`/get-chat/${chatId}`, options);
   }
 
+  /**
+   * Update metadata and sensitive data storage settings for an existing chat.
+   *
+   * @example
+   * ```ts
+   * const chatResponse = await client.chat.update(
+   *   'chat_98c1a2157aa0559144d67bb0729',
+   *   {
+   *     data_storage_setting: 'everything',
+   *     metadata: {
+   *       customer_id: 'cust_123',
+   *       notes: 'Follow-up required',
+   *     },
+   *     override_dynamic_variables: {
+   *       additional_discount: '15%',
+   *     },
+   *   },
+   * );
+   * ```
+   */
+  update(
+    chatId: string,
+    body: ChatUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ChatResponse> {
+    return this._client.patch(`/update-chat/${chatId}`, { body, ...options });
+  }
+
   /**
    * List all chats
    *
@@ -572,6 +600,31 @@ export interface ChatCreateParams {
   retell_llm_dynamic_variables?: { [key: string]: unknown };
 }
 
+export interface ChatUpdateParams {
+  /**
+   * Data storage setting for this chat. Overrides the agent's default setting.
+   * "everything" stores all data, "basic_attributes_only" stores only metadata.
+   * Cannot be downgraded from more restrictive to less restrictive settings.
+   */
+  data_storage_setting?: 'everything' | 'basic_attributes_only';
+
+  /**
+   * An arbitrary object for storage purpose only. You can put anything here like
+   * your internal customer id associated with the chat. Not used for processing. You
+   * can later get this field from the chat object. Size limited to 50kB max.
+   */
+  metadata?: unknown;
+
+  /**
+   * Override dynamic varaibles represented as key-value pairs of strings. Setting
+   * this will override or add the dynamic variables set in the agent during the
+   * call. Only need to set the delta where you want to override, no need to set the
+   * entire dynamic variables object. Setting this to null will remove any existing
+   * override.
+   */
+  override_dynamic_variables?: { [key: string]: string } | null;
+}
+
 export interface ChatCreateChatCompletionParams {
   /**
    * Unique id of the chat to create completion.
@@ -630,6 +683,7 @@ export declare namespace Chat {
     type ChatListResponse as ChatListResponse,
     type ChatCreateChatCompletionResponse as ChatCreateChatCompletionResponse,
     type ChatCreateParams as ChatCreateParams,
+    type ChatUpdateParams as ChatUpdateParams,
     type ChatCreateChatCompletionParams as ChatCreateChatCompletionParams,
     type ChatCreateSMSChatParams as ChatCreateSMSChatParams,
   };

package/src/resources/conversation-flow.ts

@@ -231,8 +231,8 @@ export interface ConversationFlowResponse {
   start_speaker?: 'user' | 'agent';
 
   /**
-   * Whether to use strict mode for tool calls. Only applicable when using structured
-   * output models.
+   * Whether to use strict mode for tool calls. Only applicable when using certain
+   * supported models.
    */
   tool_call_strict_mode?: boolean | null;
 
@@ -7576,8 +7576,8 @@ export interface ConversationFlowCreateParams {
   start_node_id?: string | null;
 
   /**
-   * Whether to use strict mode for tool calls. Only applicable when using structured
-   * output models.
+   * Whether to use strict mode for tool calls. Only applicable when using certain
+   * supported models.
    */
   tool_call_strict_mode?: boolean | null;
 
@@ -14930,7 +14930,7 @@ export interface ConversationFlowUpdateParams {
 
   /**
    * Body param: Whether to use strict mode for tool calls. Only applicable when
-   * using structured output models.
+   * using certain supported models.
    */
   tool_call_strict_mode?: boolean | null;
 

package/src/resources/index.ts

@@ -29,6 +29,7 @@ export {
   type ChatListResponse,
   type ChatCreateChatCompletionResponse,
   type ChatCreateParams,
+  type ChatUpdateParams,
   type ChatCreateChatCompletionParams,
   type ChatCreateSMSChatParams,
 } from './chat';

package/src/resources/llm.ts

@@ -213,11 +213,11 @@ export interface LlmResponse {
     | null;
 
   /**
-   * If set to true, will enable fast tier, which uses high priority pool with more
-   * dedicated resource to ensure lower and more consistent latency, default to
-   * false. This feature usually comes with a higher cost.
+   * If set to true, will use high priority pool with more dedicated resource to
+   * ensure lower and more consistent latency, default to false. This feature usually
+   * comes with a higher cost.
    */
-  model_high_priority?: boolean;
+  model_high_priority?: boolean | null;
 
   /**
    * If set, will control the randomness of the response. Value ranging from [0,1].
@@ -254,12 +254,10 @@ export interface LlmResponse {
   states?: Array<LlmResponse.State> | null;
 
   /**
-   * Only applicable when model is gpt-4o or gpt-4o mini. If set to true, will use
-   * structured output to make sure tool call arguments follow the json schema. The
-   * time to save a new tool or change to a tool will be longer as additional
-   * processing is needed. Default to false.
+   * Whether to use strict mode for tool calls. Only applicable when using certain
+   * supported models.
    */
-  tool_call_strict_mode?: boolean;
+  tool_call_strict_mode?: boolean | null;
 
   /**
    * The version of the LLM.
@@ -1834,11 +1832,11 @@ export interface LlmCreateParams {
     | null;
 
   /**
-   * If set to true, will enable fast tier, which uses high priority pool with more
-   * dedicated resource to ensure lower and more consistent latency, default to
-   * false. This feature usually comes with a higher cost.
+   * If set to true, will use high priority pool with more dedicated resource to
+   * ensure lower and more consistent latency, default to false. This feature usually
+   * comes with a higher cost.
    */
-  model_high_priority?: boolean;
+  model_high_priority?: boolean | null;
 
   /**
    * If set, will control the randomness of the response. Value ranging from [0,1].
@@ -1875,12 +1873,10 @@ export interface LlmCreateParams {
   states?: Array<LlmCreateParams.State> | null;
 
   /**
-   * Only applicable when model is gpt-4o or gpt-4o mini. If set to true, will use
-   * structured output to make sure tool call arguments follow the json schema. The
-   * time to save a new tool or change to a tool will be longer as additional
-   * processing is needed. Default to false.
+   * Whether to use strict mode for tool calls. Only applicable when using certain
+   * supported models.
    */
-  tool_call_strict_mode?: boolean;
+  tool_call_strict_mode?: boolean | null;
 
   /**
    * The version of the LLM.
@@ -3470,11 +3466,11 @@ export interface LlmUpdateParams {
     | null;
 
   /**
-   * Body param: If set to true, will enable fast tier, which uses high priority pool
-   * with more dedicated resource to ensure lower and more consistent latency,
-   * default to false. This feature usually comes with a higher cost.
+   * Body param: If set to true, will use high priority pool with more dedicated
+   * resource to ensure lower and more consistent latency, default to false. This
+   * feature usually comes with a higher cost.
    */
-  model_high_priority?: boolean;
+  model_high_priority?: boolean | null;
 
   /**
    * Body param: If set, will control the randomness of the response. Value ranging
@@ -3511,12 +3507,10 @@ export interface LlmUpdateParams {
   states?: Array<LlmUpdateParams.State> | null;
 
   /**
-   * Body param: Only applicable when model is gpt-4o or gpt-4o mini. If set to true,
-   * will use structured output to make sure tool call arguments follow the json
-   * schema. The time to save a new tool or change to a tool will be longer as
-   * additional processing is needed. Default to false.
+   * Body param: Whether to use strict mode for tool calls. Only applicable when
+   * using certain supported models.
    */
-  tool_call_strict_mode?: boolean;
+  tool_call_strict_mode?: boolean | null;
 
   /**
    * Body param: The version of the LLM.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.58.0'; // x-release-please-version
+export const VERSION = '4.59.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.58.0";
+export declare const VERSION = "4.59.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '4.58.0'; // x-release-please-version
+exports.VERSION = '4.59.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '4.58.0'; // x-release-please-version
+export const VERSION = '4.59.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map