release: 5.41.0

.release-please-manifest.json

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

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 76
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell/retell-356ae1b31c09ea2eaf1c24a93ff146e80880922a019050d6e0b6f3af2a59f565.yml
+configured_endpoints: 78
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell/retell-adebb862ab8e9696e1ddf4d31eca1083463b0c0f394beac34fdd68b1eda50692.yml
 openapi_spec_hash: 0b21f22e97c2740d2402c697d933dbd7
-config_hash: 563668cc30bc4847932ba265108c000c
+config_hash: c623d861855875b89ec85b087daf7f22

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** api update ([bac6318](https://github.com/RetellAI/retell-python-sdk/commit/bac63189e8fc23dc646e5922fe239849eb1dd57f))
+
 ## 5.40.0 (2026-05-18)
 
 Full Changelog: [v5.39.1...v5.40.0](https://github.com/RetellAI/retell-python-sdk/compare/v5.39.1...v5.40.0)

api.md

@@ -58,7 +58,12 @@ Methods:
 Types:
 
 ```python
-from retell.types import AgentResponse, AgentListResponse, AgentGetVersionsResponse
+from retell.types import (
+    AgentResponse,
+    AgentListResponse,
+    AgentCreateVersionResponse,
+    AgentGetVersionsResponse,
+)
 ```
 
 Methods:
@@ -68,6 +73,8 @@ Methods:
 - <code title="patch /update-agent/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">update</a>(agent_id, \*\*<a href="src/retell/types/agent_update_params.py">params</a>) -> <a href="./src/retell/types/agent_response.py">AgentResponse</a></code>
 - <code title="get /list-agents">client.agent.<a href="./src/retell/resources/agent.py">list</a>(\*\*<a href="src/retell/types/agent_list_params.py">params</a>) -> <a href="./src/retell/types/agent_list_response.py">AgentListResponse</a></code>
 - <code title="delete /delete-agent/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">delete</a>(agent_id) -> None</code>
+- <code title="post /create-agent-version/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">create_version</a>(agent_id, \*\*<a href="src/retell/types/agent_create_version_params.py">params</a>) -> <a href="./src/retell/types/agent_create_version_response.py">AgentCreateVersionResponse</a></code>
+- <code title="delete /delete-agent-version/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">delete_version</a>(agent_id, \*\*<a href="src/retell/types/agent_delete_version_params.py">params</a>) -> None</code>
 - <code title="get /get-agent-versions/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">get_versions</a>(agent_id) -> <a href="./src/retell/types/agent_get_versions_response.py">AgentGetVersionsResponse</a></code>
 - <code title="post /publish-agent-version/{agent_id}">client.agent.<a href="./src/retell/resources/agent.py">publish</a>(agent_id, \*\*<a href="src/retell/types/agent_publish_params.py">params</a>) -> None</code>
 
@@ -76,7 +83,12 @@ Methods:
 Types:
 
 ```python
-from retell.types import ChatAgentResponse, ChatAgentListResponse, ChatAgentGetVersionsResponse
+from retell.types import (
+    ChatAgentResponse,
+    ChatAgentListResponse,
+    ChatAgentCreateVersionResponse,
+    ChatAgentGetVersionsResponse,
+)
 ```
 
 Methods:
@@ -86,6 +98,8 @@ Methods:
 - <code title="patch /update-chat-agent/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">update</a>(agent_id, \*\*<a href="src/retell/types/chat_agent_update_params.py">params</a>) -> <a href="./src/retell/types/chat_agent_response.py">ChatAgentResponse</a></code>
 - <code title="get /list-chat-agents">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">list</a>(\*\*<a href="src/retell/types/chat_agent_list_params.py">params</a>) -> <a href="./src/retell/types/chat_agent_list_response.py">ChatAgentListResponse</a></code>
 - <code title="delete /delete-chat-agent/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">delete</a>(agent_id) -> None</code>
+- <code title="post /create-agent-version/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">create_version</a>(agent_id, \*\*<a href="src/retell/types/chat_agent_create_version_params.py">params</a>) -> <a href="./src/retell/types/chat_agent_create_version_response.py">ChatAgentCreateVersionResponse</a></code>
+- <code title="delete /delete-agent-version/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">delete_version</a>(agent_id, \*\*<a href="src/retell/types/chat_agent_delete_version_params.py">params</a>) -> None</code>
 - <code title="get /get-chat-agent-versions/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">get_versions</a>(agent_id) -> <a href="./src/retell/types/chat_agent_get_versions_response.py">ChatAgentGetVersionsResponse</a></code>
 - <code title="post /publish-agent-version/{agent_id}">client.chat_agent.<a href="./src/retell/resources/chat_agent.py">publish</a>(agent_id, \*\*<a href="src/retell/types/chat_agent_publish_params.py">params</a>) -> None</code>
 

pyproject.toml

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

src/retell/resources/agent.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Iterable, Optional
+from typing import Any, List, Union, Iterable, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -13,6 +13,8 @@
     agent_update_params,
     agent_publish_params,
     agent_retrieve_params,
+    agent_create_version_params,
+    agent_delete_version_params,
 )
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
@@ -28,6 +30,7 @@
 from ..types.agent_response import AgentResponse
 from ..types.agent_list_response import AgentListResponse
 from ..types.agent_get_versions_response import AgentGetVersionsResponse
+from ..types.agent_create_version_response import AgentCreateVersionResponse
 
 __all__ = ["AgentResource", "AsyncAgentResource"]
 
@@ -1360,6 +1363,91 @@ def delete(
             cast_to=NoneType,
         )
 
+    def create_version(
+        self,
+        agent_id: str,
+        *,
+        base_version: int,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentCreateVersionResponse:
+        """
+        Create a new draft agent version from a base version.
+
+        Args:
+          base_version: Existing version used as the base when creating a new draft.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        return cast(
+            AgentCreateVersionResponse,
+            self._post(
+                path_template("/create-agent-version/{agent_id}", agent_id=agent_id),
+                body=maybe_transform(
+                    {"base_version": base_version}, agent_create_version_params.AgentCreateVersionParams
+                ),
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(
+                    Any, AgentCreateVersionResponse
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+    def delete_version(
+        self,
+        agent_id: str,
+        *,
+        version: int,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Delete a specific agent version.
+
+        Args:
+          version: Version to delete.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            path_template("/delete-agent-version/{agent_id}", agent_id=agent_id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"version": version}, agent_delete_version_params.AgentDeleteVersionParams),
+            ),
+            cast_to=NoneType,
+        )
+
     def get_versions(
         self,
         agent_id: str,
@@ -2765,6 +2853,93 @@ async def delete(
             cast_to=NoneType,
         )
 
+    async def create_version(
+        self,
+        agent_id: str,
+        *,
+        base_version: int,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentCreateVersionResponse:
+        """
+        Create a new draft agent version from a base version.
+
+        Args:
+          base_version: Existing version used as the base when creating a new draft.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        return cast(
+            AgentCreateVersionResponse,
+            await self._post(
+                path_template("/create-agent-version/{agent_id}", agent_id=agent_id),
+                body=await async_maybe_transform(
+                    {"base_version": base_version}, agent_create_version_params.AgentCreateVersionParams
+                ),
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=cast(
+                    Any, AgentCreateVersionResponse
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+    async def delete_version(
+        self,
+        agent_id: str,
+        *,
+        version: int,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Delete a specific agent version.
+
+        Args:
+          version: Version to delete.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            path_template("/delete-agent-version/{agent_id}", agent_id=agent_id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {"version": version}, agent_delete_version_params.AgentDeleteVersionParams
+                ),
+            ),
+            cast_to=NoneType,
+        )
+
     async def get_versions(
         self,
         agent_id: str,
@@ -2861,6 +3036,12 @@ def __init__(self, agent: AgentResource) -> None:
         self.delete = to_raw_response_wrapper(
             agent.delete,
         )
+        self.create_version = to_raw_response_wrapper(
+            agent.create_version,
+        )
+        self.delete_version = to_raw_response_wrapper(
+            agent.delete_version,
+        )
         self.get_versions = to_raw_response_wrapper(
             agent.get_versions,
         )
@@ -2888,6 +3069,12 @@ def __init__(self, agent: AsyncAgentResource) -> None:
         self.delete = async_to_raw_response_wrapper(
             agent.delete,
         )
+        self.create_version = async_to_raw_response_wrapper(
+            agent.create_version,
+        )
+        self.delete_version = async_to_raw_response_wrapper(
+            agent.delete_version,
+        )
         self.get_versions = async_to_raw_response_wrapper(
             agent.get_versions,
         )
@@ -2915,6 +3102,12 @@ def __init__(self, agent: AgentResource) -> None:
         self.delete = to_streamed_response_wrapper(
             agent.delete,
         )
+        self.create_version = to_streamed_response_wrapper(
+            agent.create_version,
+        )
+        self.delete_version = to_streamed_response_wrapper(
+            agent.delete_version,
+        )
         self.get_versions = to_streamed_response_wrapper(
             agent.get_versions,
         )
@@ -2942,6 +3135,12 @@ def __init__(self, agent: AsyncAgentResource) -> None:
         self.delete = async_to_streamed_response_wrapper(
             agent.delete,
         )
+        self.create_version = async_to_streamed_response_wrapper(
+            agent.create_version,
+        )
+        self.delete_version = async_to_streamed_response_wrapper(
+            agent.delete_version,
+        )
         self.get_versions = async_to_streamed_response_wrapper(
             agent.get_versions,
         )