release: 5.24.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "5.23.0"
+  ".": "5.24.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 73
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Fretell-3aa6f6e028ef4d49bed8719dd097acb4c8d9d6afa27a499faa2e9d02782ac2bd.yml
-openapi_spec_hash: 47fc2e2f939e51932b6726a705877e1a
-config_hash: b8e300898f198b40935f8cf775a07e2d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Fretell-56de19127afbdf111fd60a0aa1188496712acbcf9069d535396af6e66a0afd70.yml
+openapi_spec_hash: a56e1bcb7ab38d9fade4a42840e7e15f
+config_hash: bf63cd880955c4d6be170f4c6c68959e

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.24.0 (2026-04-01)
+
+Full Changelog: [v5.23.0...v5.24.0](https://github.com/RetellAI/retell-python-sdk/compare/v5.23.0...v5.24.0)
+
+### Features
+
+* **api:** api update ([bef8663](https://github.com/RetellAI/retell-python-sdk/commit/bef8663280eb89c6bf06f990a37059ebcb0f80ca))
+
 ## 5.23.0 (2026-03-27)
 
 Full Changelog: [v5.22.2...v5.23.0](https://github.com/RetellAI/retell-python-sdk/compare/v5.22.2...v5.23.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "retell-sdk"
-version = "5.23.0"
+version = "5.24.0"
 description = "The official Python library for the retell API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/retell/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "retell"
-__version__ = "5.23.0"  # x-release-please-version
+__version__ = "5.24.0"  # x-release-please-version

src/retell/resources/agent.py

@@ -78,6 +78,7 @@ def create(
         end_call_after_silence_ms: int | Omit = omit,
         fallback_voice_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         guardrail_config: agent_create_params.GuardrailConfig | Omit = omit,
+        handbook_config: agent_create_params.HandbookConfig | Omit = omit,
         interruption_sensitivity: float | Omit = omit,
         is_public: Optional[bool] | Omit = omit,
         ivr_option: Optional[agent_create_params.IvrOption] | Omit = omit,
@@ -182,6 +183,7 @@ def create(
         ring_duration_ms: int | Omit = omit,
         signed_url_expiration_ms: Optional[int] | Omit = omit,
         stt_mode: Literal["fast", "accurate", "custom"] | Omit = omit,
+        timezone: Optional[str] | Omit = omit,
         user_dtmf_options: Optional[agent_create_params.UserDtmfOptions] | Omit = omit,
         version_description: Optional[str] | Omit = omit,
         vocab_specialization: Literal["general", "medical"] | Omit = omit,
@@ -348,6 +350,8 @@ def create(
           guardrail_config: Configuration for guardrail checks to detect and prevent prohibited topics in
               agent output and user input.
 
+          handbook_config: Toggle behavior presets on/off to influence agent response style and behaviors.
+
           interruption_sensitivity: Controls how sensitive the agent is to user interruptions. Value ranging from
               [0,1]. Lower value means it will take longer / more words for user to interrupt
               agent, while higher value means it's easier for user to interrupt agent. If
@@ -419,6 +423,9 @@ def create(
           stt_mode: If set, determines whether speech to text should focus on latency or accuracy.
               Default to fast mode. When set to custom, custom_stt_config must be provided.
 
+          timezone: IANA timezone for the agent (e.g. America/New_York). Defaults to
+              America/Los_Angeles if not set.
+
           version_description: Optional description of the agent version. Used for your own reference and
               documentation.
 
@@ -506,6 +513,7 @@ def create(
                     "end_call_after_silence_ms": end_call_after_silence_ms,
                     "fallback_voice_ids": fallback_voice_ids,
                     "guardrail_config": guardrail_config,
+                    "handbook_config": handbook_config,
                     "interruption_sensitivity": interruption_sensitivity,
                     "is_public": is_public,
                     "ivr_option": ivr_option,
@@ -523,6 +531,7 @@ def create(
                     "ring_duration_ms": ring_duration_ms,
                     "signed_url_expiration_ms": signed_url_expiration_ms,
                     "stt_mode": stt_mode,
+                    "timezone": timezone,
                     "user_dtmf_options": user_dtmf_options,
                     "version_description": version_description,
                     "vocab_specialization": vocab_specialization,
@@ -619,6 +628,7 @@ def update(
         end_call_after_silence_ms: int | Omit = omit,
         fallback_voice_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         guardrail_config: agent_update_params.GuardrailConfig | Omit = omit,
+        handbook_config: agent_update_params.HandbookConfig | Omit = omit,
         interruption_sensitivity: float | Omit = omit,
         is_public: Optional[bool] | Omit = omit,
         ivr_option: Optional[agent_update_params.IvrOption] | Omit = omit,
@@ -724,6 +734,7 @@ def update(
         ring_duration_ms: int | Omit = omit,
         signed_url_expiration_ms: Optional[int] | Omit = omit,
         stt_mode: Literal["fast", "accurate", "custom"] | Omit = omit,
+        timezone: Optional[str] | Omit = omit,
         user_dtmf_options: Optional[agent_update_params.UserDtmfOptions] | Omit = omit,
         version_description: Optional[str] | Omit = omit,
         vocab_specialization: Literal["general", "medical"] | Omit = omit,
@@ -886,6 +897,8 @@ def update(
           guardrail_config: Configuration for guardrail checks to detect and prevent prohibited topics in
               agent output and user input.
 
+          handbook_config: Toggle behavior presets on/off to influence agent response style and behaviors.
+
           interruption_sensitivity: Controls how sensitive the agent is to user interruptions. Value ranging from
               [0,1]. Lower value means it will take longer / more words for user to interrupt
               agent, while higher value means it's easier for user to interrupt agent. If
@@ -961,6 +974,9 @@ def update(
           stt_mode: If set, determines whether speech to text should focus on latency or accuracy.
               Default to fast mode. When set to custom, custom_stt_config must be provided.
 
+          timezone: IANA timezone for the agent (e.g. America/New_York). Defaults to
+              America/Los_Angeles if not set.
+
           version_description: Optional description of the agent version. Used for your own reference and
               documentation.
 
@@ -1051,6 +1067,7 @@ def update(
                     "end_call_after_silence_ms": end_call_after_silence_ms,
                     "fallback_voice_ids": fallback_voice_ids,
                     "guardrail_config": guardrail_config,
+                    "handbook_config": handbook_config,
                     "interruption_sensitivity": interruption_sensitivity,
                     "is_public": is_public,
                     "ivr_option": ivr_option,
@@ -1069,6 +1086,7 @@ def update(
                     "ring_duration_ms": ring_duration_ms,
                     "signed_url_expiration_ms": signed_url_expiration_ms,
                     "stt_mode": stt_mode,
+                    "timezone": timezone,
                     "user_dtmf_options": user_dtmf_options,
                     "version_description": version_description,
                     "vocab_specialization": vocab_specialization,
@@ -1308,6 +1326,7 @@ async def create(
         end_call_after_silence_ms: int | Omit = omit,
         fallback_voice_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         guardrail_config: agent_create_params.GuardrailConfig | Omit = omit,
+        handbook_config: agent_create_params.HandbookConfig | Omit = omit,
         interruption_sensitivity: float | Omit = omit,
         is_public: Optional[bool] | Omit = omit,
         ivr_option: Optional[agent_create_params.IvrOption] | Omit = omit,
@@ -1412,6 +1431,7 @@ async def create(
         ring_duration_ms: int | Omit = omit,
         signed_url_expiration_ms: Optional[int] | Omit = omit,
         stt_mode: Literal["fast", "accurate", "custom"] | Omit = omit,
+        timezone: Optional[str] | Omit = omit,
         user_dtmf_options: Optional[agent_create_params.UserDtmfOptions] | Omit = omit,
         version_description: Optional[str] | Omit = omit,
         vocab_specialization: Literal["general", "medical"] | Omit = omit,
@@ -1578,6 +1598,8 @@ async def create(
           guardrail_config: Configuration for guardrail checks to detect and prevent prohibited topics in
               agent output and user input.
 
+          handbook_config: Toggle behavior presets on/off to influence agent response style and behaviors.
+
           interruption_sensitivity: Controls how sensitive the agent is to user interruptions. Value ranging from
               [0,1]. Lower value means it will take longer / more words for user to interrupt
               agent, while higher value means it's easier for user to interrupt agent. If
@@ -1649,6 +1671,9 @@ async def create(
           stt_mode: If set, determines whether speech to text should focus on latency or accuracy.
               Default to fast mode. When set to custom, custom_stt_config must be provided.
 
+          timezone: IANA timezone for the agent (e.g. America/New_York). Defaults to
+              America/Los_Angeles if not set.
+
           version_description: Optional description of the agent version. Used for your own reference and
               documentation.
 
@@ -1736,6 +1761,7 @@ async def create(
                     "end_call_after_silence_ms": end_call_after_silence_ms,
                     "fallback_voice_ids": fallback_voice_ids,
                     "guardrail_config": guardrail_config,
+                    "handbook_config": handbook_config,
                     "interruption_sensitivity": interruption_sensitivity,
                     "is_public": is_public,
                     "ivr_option": ivr_option,
@@ -1753,6 +1779,7 @@ async def create(
                     "ring_duration_ms": ring_duration_ms,
                     "signed_url_expiration_ms": signed_url_expiration_ms,
                     "stt_mode": stt_mode,
+                    "timezone": timezone,
                     "user_dtmf_options": user_dtmf_options,
                     "version_description": version_description,
                     "vocab_specialization": vocab_specialization,
@@ -1849,6 +1876,7 @@ async def update(
         end_call_after_silence_ms: int | Omit = omit,
         fallback_voice_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         guardrail_config: agent_update_params.GuardrailConfig | Omit = omit,
+        handbook_config: agent_update_params.HandbookConfig | Omit = omit,
         interruption_sensitivity: float | Omit = omit,
         is_public: Optional[bool] | Omit = omit,
         ivr_option: Optional[agent_update_params.IvrOption] | Omit = omit,
@@ -1954,6 +1982,7 @@ async def update(
         ring_duration_ms: int | Omit = omit,
         signed_url_expiration_ms: Optional[int] | Omit = omit,
         stt_mode: Literal["fast", "accurate", "custom"] | Omit = omit,
+        timezone: Optional[str] | Omit = omit,
         user_dtmf_options: Optional[agent_update_params.UserDtmfOptions] | Omit = omit,
         version_description: Optional[str] | Omit = omit,
         vocab_specialization: Literal["general", "medical"] | Omit = omit,
@@ -2116,6 +2145,8 @@ async def update(
           guardrail_config: Configuration for guardrail checks to detect and prevent prohibited topics in
               agent output and user input.
 
+          handbook_config: Toggle behavior presets on/off to influence agent response style and behaviors.
+
           interruption_sensitivity: Controls how sensitive the agent is to user interruptions. Value ranging from
               [0,1]. Lower value means it will take longer / more words for user to interrupt
               agent, while higher value means it's easier for user to interrupt agent. If
@@ -2191,6 +2222,9 @@ async def update(
           stt_mode: If set, determines whether speech to text should focus on latency or accuracy.
               Default to fast mode. When set to custom, custom_stt_config must be provided.
 
+          timezone: IANA timezone for the agent (e.g. America/New_York). Defaults to
+              America/Los_Angeles if not set.
+
           version_description: Optional description of the agent version. Used for your own reference and
               documentation.
 
@@ -2281,6 +2315,7 @@ async def update(
                     "end_call_after_silence_ms": end_call_after_silence_ms,
                     "fallback_voice_ids": fallback_voice_ids,
                     "guardrail_config": guardrail_config,
+                    "handbook_config": handbook_config,
                     "interruption_sensitivity": interruption_sensitivity,
                     "is_public": is_public,
                     "ivr_option": ivr_option,
@@ -2299,6 +2334,7 @@ async def update(
                     "ring_duration_ms": ring_duration_ms,
                     "signed_url_expiration_ms": signed_url_expiration_ms,
                     "stt_mode": stt_mode,
+                    "timezone": timezone,
                     "user_dtmf_options": user_dtmf_options,
                     "version_description": version_description,
                     "vocab_specialization": vocab_specialization,