release: 5.42.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "5.41.0"
+  ".": "5.42.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 78
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell/retell-adebb862ab8e9696e1ddf4d31eca1083463b0c0f394beac34fdd68b1eda50692.yml
-openapi_spec_hash: 0b21f22e97c2740d2402c697d933dbd7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell/retell-333e5bbb4a130497aa1d6aa11ecc36526bf9a519ac72ec8c8e11b30bae0f37e2.yml
+openapi_spec_hash: 82a6ba7edd83f02038df58abfa4a30bf
 config_hash: c623d861855875b89ec85b087daf7f22

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.42.0 (2026-05-28)
+
+Full Changelog: [v5.41.0...v5.42.0](https://github.com/RetellAI/retell-python-sdk/compare/v5.41.0...v5.42.0)
+
+### Features
+
+* **api:** api update ([613e4a7](https://github.com/RetellAI/retell-python-sdk/commit/613e4a75204e6858e2e609c1b41bac17c512f746))
+
 ## 5.41.0 (2026-05-21)
 
 Full Changelog: [v5.40.0...v5.41.0](https://github.com/RetellAI/retell-python-sdk/compare/v5.40.0...v5.41.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "retell-sdk"
-version = "5.41.0"
+version = "5.42.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.41.0"  # x-release-please-version
+__version__ = "5.42.0"  # x-release-please-version

src/retell/resources/agent.py

@@ -391,7 +391,7 @@ def create(
 
           boosted_keywords: Provide a customized list of keywords to bias the transcriber model, so that
               these words are more likely to get transcribed. Commonly used for names, brands,
-              street, etc.
+              street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
 
           call_screening_option: If this option is set, the agent prompt will include call screen handling
               instructions for identity and call purpose questions. Set this to null to
@@ -1011,7 +1011,7 @@ def update(
 
           boosted_keywords: Provide a customized list of keywords to bias the transcriber model, so that
               these words are more likely to get transcribed. Commonly used for names, brands,
-              street, etc.
+              street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
 
           call_screening_option: If this option is set, the agent prompt will include call screen handling
               instructions for identity and call purpose questions. Set this to null to
@@ -1881,7 +1881,7 @@ async def create(
 
           boosted_keywords: Provide a customized list of keywords to bias the transcriber model, so that
               these words are more likely to get transcribed. Commonly used for names, brands,
-              street, etc.
+              street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
 
           call_screening_option: If this option is set, the agent prompt will include call screen handling
               instructions for identity and call purpose questions. Set this to null to
@@ -2501,7 +2501,7 @@ async def update(
 
           boosted_keywords: Provide a customized list of keywords to bias the transcriber model, so that
               these words are more likely to get transcribed. Commonly used for names, brands,
-              street, etc.
+              street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
 
           call_screening_option: If this option is set, the agent prompt will include call screen handling
               instructions for identity and call purpose questions. Set this to null to

src/retell/resources/call.py

@@ -120,7 +120,7 @@ def update(
               your internal customer id associated with the call. Not used for processing. You
               can later get this field from the call object. Size limited to 50kB max.
 
-          override_dynamic_variables: Override dynamic varaibles represented as key-value pairs of strings. Setting
+          override_dynamic_variables: Override dynamic variables 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
@@ -610,7 +610,7 @@ async def update(
               your internal customer id associated with the call. Not used for processing. You
               can later get this field from the call object. Size limited to 50kB max.
 
-          override_dynamic_variables: Override dynamic varaibles represented as key-value pairs of strings. Setting
+          override_dynamic_variables: Override dynamic variables 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

src/retell/resources/chat.py

@@ -171,7 +171,7 @@ def update(
               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.
 
-          override_dynamic_variables: Override dynamic varaibles represented as key-value pairs of strings. Setting
+          override_dynamic_variables: Override dynamic variables 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
@@ -207,7 +207,7 @@ def update(
     def list(
         self,
         *,
-        filter_criteria: object | Omit = omit,
+        filter_criteria: chat_list_params.FilterCriteria | Omit = omit,
         include_total: bool | Omit = omit,
         limit: int | Omit = omit,
         pagination_key: str | Omit = omit,
@@ -589,7 +589,7 @@ async def update(
               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.
 
-          override_dynamic_variables: Override dynamic varaibles represented as key-value pairs of strings. Setting
+          override_dynamic_variables: Override dynamic variables 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
@@ -625,7 +625,7 @@ async def update(
     async def list(
         self,
         *,
-        filter_criteria: object | Omit = omit,
+        filter_criteria: chat_list_params.FilterCriteria | Omit = omit,
         include_total: bool | Omit = omit,
         limit: int | Omit = omit,
         pagination_key: str | Omit = omit,

src/retell/types/agent_create_params.py

@@ -148,7 +148,7 @@ class AgentCreateParams(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[CallScreeningOption]

src/retell/types/agent_response.py

@@ -571,7 +571,7 @@ class AgentResponse(BaseModel):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[CallScreeningOption] = None

src/retell/types/agent_update_params.py

@@ -138,7 +138,7 @@ class AgentUpdateParams(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[CallScreeningOption]

src/retell/types/batch_call_create_batch_call_params.py

@@ -598,7 +598,7 @@ class TaskAgentOverrideAgent(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[TaskAgentOverrideAgentCallScreeningOption]

src/retell/types/call_create_phone_call_params.py

@@ -617,7 +617,7 @@ class AgentOverrideAgent(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[AgentOverrideAgentCallScreeningOption]

src/retell/types/call_create_web_call_params.py

@@ -604,7 +604,7 @@ class AgentOverrideAgent(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[AgentOverrideAgentCallScreeningOption]

src/retell/types/call_list_params.py

@@ -379,6 +379,7 @@ class FilterCriteriaDisconnectionReason(TypedDict, total=False):
                 "inactivity",
                 "max_duration_reached",
                 "concurrency_limit_reached",
+                "no_concurrency_fallback",
                 "no_valid_payment",
                 "scam_detected",
                 "dial_busy",

src/retell/types/call_list_response.py

@@ -444,6 +444,7 @@ class ItemV3WebCallResponse(BaseModel):
             "inactivity",
             "max_duration_reached",
             "concurrency_limit_reached",
+            "no_concurrency_fallback",
             "no_valid_payment",
             "scam_detected",
             "dial_busy",
@@ -996,6 +997,7 @@ class ItemV3PhoneCallResponse(BaseModel):
             "inactivity",
             "max_duration_reached",
             "concurrency_limit_reached",
+            "no_concurrency_fallback",
             "no_valid_payment",
             "scam_detected",
             "dial_busy",

src/retell/types/call_register_phone_call_params.py

@@ -595,7 +595,7 @@ class AgentOverrideAgent(TypedDict, total=False):
     """
     Provide a customized list of keywords to bias the transcriber model, so that
     these words are more likely to get transcribed. Commonly used for names, brands,
-    street, etc.
+    street, etc. Entries may reference dynamic variables with `{{variable}}` syntax.
     """
 
     call_screening_option: Optional[AgentOverrideAgentCallScreeningOption]

src/retell/types/call_update_params.py

@@ -30,7 +30,7 @@ class CallUpdateParams(TypedDict, total=False):
     """
 
     override_dynamic_variables: Optional[Dict[str, str]]
-    """Override dynamic varaibles represented as key-value pairs of strings.
+    """Override dynamic variables 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