release: 4.34.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.33.0"
+  ".": "4.34.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 39
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Ftoddlzt-6f9abd242d6ae2ff1402a11e59ee5c26fcac97bb4a3780fb9e12096d542c6b61.yml
-openapi_spec_hash: f5995d0f2a7ce0b2a88777b75dd6823f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Ftoddlzt-a0dea2a1f12785ff40f1a6f1f9570781c63ba372dbb744f2fc61e0c5451f3bef.yml
+openapi_spec_hash: 8083df98dc88d4882446f7165d28e0ea
 config_hash: f4bc63f2350a2a4988750b41a0737f9d

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 4.34.0 (2025-06-11)
+
+Full Changelog: [v4.33.0...v4.34.0](https://github.com/RetellAI/retell-python-sdk/compare/v4.33.0...v4.34.0)
+
+### Features
+
+* **api:** api update ([c141937](https://github.com/RetellAI/retell-python-sdk/commit/c1419375a721b271fe86806aad499deab7ef81d3))
+* **api:** api update ([8f76d19](https://github.com/RetellAI/retell-python-sdk/commit/8f76d19d499df917abf861c79e1f92a9d95a419c))
+* **api:** api update ([80cfbfb](https://github.com/RetellAI/retell-python-sdk/commit/80cfbfb0c62135ecefc7cd92ea5829bbedd99881))
+* **api:** api update ([e52831a](https://github.com/RetellAI/retell-python-sdk/commit/e52831aeb49967506a1daf1b06b034368c11d865))
+* **api:** api update ([8f88a3c](https://github.com/RetellAI/retell-python-sdk/commit/8f88a3cd122c43793888cda86c20e4a3d0fa2095))
+* **api:** api update ([b2df68b](https://github.com/RetellAI/retell-python-sdk/commit/b2df68b78027f5d760b06292591ba7a1ca6a9bce))
+* **api:** api update ([8053323](https://github.com/RetellAI/retell-python-sdk/commit/8053323dbb47fef685a662767ae329d0a382cbc0))
+* **api:** api update ([35b025b](https://github.com/RetellAI/retell-python-sdk/commit/35b025bc9aa7bdc628be6b831f03745097a57023))
+
 ## 4.33.0 (2025-06-04)
 
 Full Changelog: [v4.32.0...v4.33.0](https://github.com/RetellAI/retell-python-sdk/compare/v4.32.0...v4.33.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "retell-sdk"
-version = "4.33.0"
+version = "4.34.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__ = "4.33.0"  # x-release-please-version
+__version__ = "4.34.0"  # x-release-please-version

src/retell/resources/agent.py

@@ -134,6 +134,8 @@ def create(
                 "eleven_multilingual_v2",
                 "Play3.0-mini",
                 "PlayDialog",
+                "tts-1",
+                "gpt-4o-mini-tts",
             ]
         ]
         | NotGiven = NOT_GIVEN,
@@ -529,6 +531,8 @@ def update(
                 "eleven_multilingual_v2",
                 "Play3.0-mini",
                 "PlayDialog",
+                "tts-1",
+                "gpt-4o-mini-tts",
             ]
         ]
         | NotGiven = NOT_GIVEN,
@@ -997,6 +1001,8 @@ async def create(
                 "eleven_multilingual_v2",
                 "Play3.0-mini",
                 "PlayDialog",
+                "tts-1",
+                "gpt-4o-mini-tts",
             ]
         ]
         | NotGiven = NOT_GIVEN,
@@ -1392,6 +1398,8 @@ async def update(
                 "eleven_multilingual_v2",
                 "Play3.0-mini",
                 "PlayDialog",
+                "tts-1",
+                "gpt-4o-mini-tts",
             ]
         ]
         | NotGiven = NOT_GIVEN,

src/retell/types/agent_create_params.py

@@ -314,6 +314,8 @@ class AgentCreateParams(TypedDict, total=False):
             "eleven_multilingual_v2",
             "Play3.0-mini",
             "PlayDialog",
+            "tts-1",
+            "gpt-4o-mini-tts",
         ]
     ]
     """Optionally set the voice model used for the selected voice.

src/retell/types/agent_response.py

@@ -456,6 +456,8 @@ class AgentResponse(BaseModel):
             "eleven_multilingual_v2",
             "Play3.0-mini",
             "PlayDialog",
+            "tts-1",
+            "gpt-4o-mini-tts",
         ]
     ] = None
     """Optionally set the voice model used for the selected voice.

src/retell/types/agent_update_params.py

@@ -319,6 +319,8 @@ class AgentUpdateParams(TypedDict, total=False):
             "eleven_multilingual_v2",
             "Play3.0-mini",
             "PlayDialog",
+            "tts-1",
+            "gpt-4o-mini-tts",
         ]
     ]
     """Optionally set the voice model used for the selected voice.

src/retell/types/llm_create_params.py

@@ -197,17 +197,17 @@ class GeneralToolTransferCallToolTransferDestinationTransferDestinationInferred(
 
 
 class GeneralToolTransferCallToolTransferOptionTransferOptionColdTransfer(TypedDict, total=False):
-    show_transferee_as_caller: Required[bool]
+    type: Required[Literal["cold_transfer"]]
+    """The type of the transfer."""
+
+    show_transferee_as_caller: bool
     """
     If set to true, will show transferee (the user, not the AI agent) as caller when
     transferring, requires the telephony side to support SIP REFER to PSTN. This is
     only applicable for cold transfer, so if warm transfer option is specified, this
     field will be ignored. Default to false (default to show AI agent as caller).
     """
 
-    type: Required[Literal["cold_transfer"]]
-    """The type of the transfer."""
-
 
 class GeneralToolTransferCallToolTransferOptionTransferOptionWarmTransferPublicHandoffOptionWarmTransferPrompt(
     TypedDict, total=False
@@ -433,6 +433,12 @@ class GeneralToolCustomTool(TypedDict, total=False):
     calling this tool. Make sure it fits into the conversation smoothly.".
     """
 
+    headers: Dict[str, str]
+    """Headers to add to the request."""
+
+    method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
+    """Method to use for the request, default to POST."""
+
     parameters: GeneralToolCustomToolParameters
     """The parameters the functions accepts, described as a JSON Schema object.
 
@@ -441,6 +447,16 @@ class GeneralToolCustomTool(TypedDict, total=False):
     an empty parameter list.
     """
 
+    query_params: Dict[str, str]
+    """Query parameters to append to the request URL."""
+
+    response_variables: Dict[str, str]
+    """A mapping of variable names to JSON paths in the response body.
+
+    These values will be extracted from the response and made available as dynamic
+    variables for use.
+    """
+
     timeout_ms: int
     """The maximum time in milliseconds the tool can run before it's considered
     timeout.
@@ -554,17 +570,17 @@ class StateToolTransferCallToolTransferDestinationTransferDestinationInferred(Ty
 
 
 class StateToolTransferCallToolTransferOptionTransferOptionColdTransfer(TypedDict, total=False):
-    show_transferee_as_caller: Required[bool]
+    type: Required[Literal["cold_transfer"]]
+    """The type of the transfer."""
+
+    show_transferee_as_caller: bool
     """
     If set to true, will show transferee (the user, not the AI agent) as caller when
     transferring, requires the telephony side to support SIP REFER to PSTN. This is
     only applicable for cold transfer, so if warm transfer option is specified, this
     field will be ignored. Default to false (default to show AI agent as caller).
     """
 
-    type: Required[Literal["cold_transfer"]]
-    """The type of the transfer."""
-
 
 class StateToolTransferCallToolTransferOptionTransferOptionWarmTransferPublicHandoffOptionWarmTransferPrompt(
     TypedDict, total=False
@@ -790,6 +806,12 @@ class StateToolCustomTool(TypedDict, total=False):
     calling this tool. Make sure it fits into the conversation smoothly.".
     """
 
+    headers: Dict[str, str]
+    """Headers to add to the request."""
+
+    method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
+    """Method to use for the request, default to POST."""
+
     parameters: StateToolCustomToolParameters
     """The parameters the functions accepts, described as a JSON Schema object.
 
@@ -798,6 +820,16 @@ class StateToolCustomTool(TypedDict, total=False):
     an empty parameter list.
     """
 
+    query_params: Dict[str, str]
+    """Query parameters to append to the request URL."""
+
+    response_variables: Dict[str, str]
+    """A mapping of variable names to JSON paths in the response body.
+
+    These values will be extracted from the response and made available as dynamic
+    variables for use.
+    """
+
     timeout_ms: int
     """The maximum time in milliseconds the tool can run before it's considered
     timeout.

src/retell/types/llm_response.py

@@ -98,17 +98,17 @@ class GeneralToolTransferCallToolTransferDestinationTransferDestinationInferred(
 
 
 class GeneralToolTransferCallToolTransferOptionTransferOptionColdTransfer(BaseModel):
-    show_transferee_as_caller: bool
+    type: Literal["cold_transfer"]
+    """The type of the transfer."""
+
+    show_transferee_as_caller: Optional[bool] = None
     """
     If set to true, will show transferee (the user, not the AI agent) as caller when
     transferring, requires the telephony side to support SIP REFER to PSTN. This is
     only applicable for cold transfer, so if warm transfer option is specified, this
     field will be ignored. Default to false (default to show AI agent as caller).
     """
 
-    type: Literal["cold_transfer"]
-    """The type of the transfer."""
-
 
 class GeneralToolTransferCallToolTransferOptionTransferOptionWarmTransferPublicHandoffOptionWarmTransferPrompt(
     BaseModel
@@ -336,6 +336,12 @@ class GeneralToolCustomTool(BaseModel):
     calling this tool. Make sure it fits into the conversation smoothly.".
     """
 
+    headers: Optional[Dict[str, str]] = None
+    """Headers to add to the request."""
+
+    method: Optional[Literal["GET", "POST", "PUT", "PATCH", "DELETE"]] = None
+    """Method to use for the request, default to POST."""
+
     parameters: Optional[GeneralToolCustomToolParameters] = None
     """The parameters the functions accepts, described as a JSON Schema object.
 
@@ -344,6 +350,16 @@ class GeneralToolCustomTool(BaseModel):
     an empty parameter list.
     """
 
+    query_params: Optional[Dict[str, str]] = None
+    """Query parameters to append to the request URL."""
+
+    response_variables: Optional[Dict[str, str]] = None
+    """A mapping of variable names to JSON paths in the response body.
+
+    These values will be extracted from the response and made available as dynamic
+    variables for use.
+    """
+
     timeout_ms: Optional[int] = None
     """The maximum time in milliseconds the tool can run before it's considered
     timeout.
@@ -457,17 +473,17 @@ class StateToolTransferCallToolTransferDestinationTransferDestinationInferred(Ba
 
 
 class StateToolTransferCallToolTransferOptionTransferOptionColdTransfer(BaseModel):
-    show_transferee_as_caller: bool
+    type: Literal["cold_transfer"]
+    """The type of the transfer."""
+
+    show_transferee_as_caller: Optional[bool] = None
     """
     If set to true, will show transferee (the user, not the AI agent) as caller when
     transferring, requires the telephony side to support SIP REFER to PSTN. This is
     only applicable for cold transfer, so if warm transfer option is specified, this
     field will be ignored. Default to false (default to show AI agent as caller).
     """
 
-    type: Literal["cold_transfer"]
-    """The type of the transfer."""
-
 
 class StateToolTransferCallToolTransferOptionTransferOptionWarmTransferPublicHandoffOptionWarmTransferPrompt(BaseModel):
     prompt: Optional[str] = None
@@ -693,6 +709,12 @@ class StateToolCustomTool(BaseModel):
     calling this tool. Make sure it fits into the conversation smoothly.".
     """
 
+    headers: Optional[Dict[str, str]] = None
+    """Headers to add to the request."""
+
+    method: Optional[Literal["GET", "POST", "PUT", "PATCH", "DELETE"]] = None
+    """Method to use for the request, default to POST."""
+
     parameters: Optional[StateToolCustomToolParameters] = None
     """The parameters the functions accepts, described as a JSON Schema object.
 
@@ -701,6 +723,16 @@ class StateToolCustomTool(BaseModel):
     an empty parameter list.
     """
 
+    query_params: Optional[Dict[str, str]] = None
+    """Query parameters to append to the request URL."""
+
+    response_variables: Optional[Dict[str, str]] = None
+    """A mapping of variable names to JSON paths in the response body.
+
+    These values will be extracted from the response and made available as dynamic
+    variables for use.
+    """
+
     timeout_ms: Optional[int] = None
     """The maximum time in milliseconds the tool can run before it's considered
     timeout.