vellum-ai 0.14.41__py3-none-any.whl → 1.11.2__py3-none-any.whl

vellum/client/resources/workflow_deployments/client.py

@@ -1,22 +1,21 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ...core.client_wrapper import SyncClientWrapper
-from .types.workflow_deployments_list_request_status import WorkflowDeploymentsListRequestStatus
+
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.paginated_slim_workflow_deployment_list import PaginatedSlimWorkflowDeploymentList
-from ...core.pydantic_utilities import parse_obj_as
-from json.decoder import JSONDecodeError
-from ...core.api_error import ApiError
-from ...types.workflow_deployment_read import WorkflowDeploymentRead
-from ...core.jsonable_encoder import jsonable_encoder
+from ...types.paginated_workflow_deployment_release_list import PaginatedWorkflowDeploymentReleaseList
+from ...types.paginated_workflow_release_tag_read_list import PaginatedWorkflowReleaseTagReadList
 from ...types.workflow_deployment_event_executions_response import WorkflowDeploymentEventExecutionsResponse
-from ...types.workflow_event_execution_read import WorkflowEventExecutionRead
 from ...types.workflow_deployment_history_item import WorkflowDeploymentHistoryItem
-from .types.list_workflow_release_tags_request_source import ListWorkflowReleaseTagsRequestSource
-from ...types.paginated_workflow_release_tag_read_list import PaginatedWorkflowReleaseTagReadList
+from ...types.workflow_deployment_read import WorkflowDeploymentRead
+from ...types.workflow_deployment_release import WorkflowDeploymentRelease
+from ...types.workflow_event_execution_read import WorkflowEventExecutionRead
 from ...types.workflow_release_tag_read import WorkflowReleaseTagRead
-from ...core.client_wrapper import AsyncClientWrapper
+from .raw_client import AsyncRawWorkflowDeploymentsClient, RawWorkflowDeploymentsClient
+from .types.list_workflow_release_tags_request_source import ListWorkflowReleaseTagsRequestSource
+from .types.workflow_deployments_list_request_status import WorkflowDeploymentsListRequestStatus
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -24,7 +23,22 @@ OMIT = typing.cast(typing.Any, ...)
 
 class WorkflowDeploymentsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = RawWorkflowDeploymentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def _client_wrapper(self) -> SyncClientWrapper:
+        return self._raw_client._client_wrapper
+
+    @property
+    def with_raw_response(self) -> RawWorkflowDeploymentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawWorkflowDeploymentsClient
+        """
+        return self._raw_client
 
     def list(
         self,
@@ -65,35 +79,15 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.list()
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/workflow-deployments",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "limit": limit,
-                "offset": offset,
-                "ordering": ordering,
-                "status": status,
-            },
-            request_options=request_options,
+        _response = self._raw_client.list(
+            limit=limit, offset=offset, ordering=ordering, status=status, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PaginatedSlimWorkflowDeploymentList,
-                    parse_obj_as(
-                        type_=PaginatedSlimWorkflowDeploymentList,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def retrieve(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> WorkflowDeploymentRead:
         """
@@ -117,31 +111,15 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.retrieve(
             id="id",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentRead,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.retrieve(id, request_options=request_options)
+        return _response.data
 
     def list_workflow_deployment_event_executions(
         self,
@@ -150,6 +128,7 @@ class WorkflowDeploymentsClient:
         filters: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkflowDeploymentEventExecutionsResponse:
         """
@@ -165,6 +144,8 @@ class WorkflowDeploymentsClient:
         offset : typing.Optional[int]
             The initial index from which to return the executions.
 
+        ordering : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -178,36 +159,17 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.list_workflow_deployment_event_executions(
             id="id",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "filters": filters,
-                "limit": limit,
-                "offset": offset,
-            },
-            request_options=request_options,
+        _response = self._raw_client.list_workflow_deployment_event_executions(
+            id, filters=filters, limit=limit, offset=offset, ordering=ordering, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentEventExecutionsResponse,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentEventExecutionsResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def workflow_deployment_event_execution(
         self, execution_id: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -232,6 +194,7 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.workflow_deployment_event_execution(
@@ -239,31 +202,17 @@ class WorkflowDeploymentsClient:
             id="id",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events/{jsonable_encoder(execution_id)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
+        _response = self._raw_client.workflow_deployment_event_execution(
+            execution_id, id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowEventExecutionRead,
-                    parse_obj_as(
-                        type_=WorkflowEventExecutionRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def workflow_deployment_history_item_retrieve(
         self, history_id_or_release_tag: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> WorkflowDeploymentHistoryItem:
         """
-        Retrieve a specific Workflow Deployment History Item by either its UUID or the name of a Release Tag that points to it.
+        DEPRECATED: This endpoint is deprecated and will be removed in a future release. Please use the
+        `retrieve_workflow_deployment_release` endpoint instead.
 
         Parameters
         ----------
@@ -271,7 +220,7 @@ class WorkflowDeploymentsClient:
             Either the UUID of Workflow Deployment History Item you'd like to retrieve, or the name of a Release Tag that's pointing to the Workflow Deployment History Item you'd like to retrieve.
 
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -286,6 +235,7 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.workflow_deployment_history_item_retrieve(
@@ -293,25 +243,10 @@ class WorkflowDeploymentsClient:
             id="id",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/history/{jsonable_encoder(history_id_or_release_tag)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
+        _response = self._raw_client.workflow_deployment_history_item_retrieve(
+            history_id_or_release_tag, id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentHistoryItem,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentHistoryItem,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def list_workflow_release_tags(
         self,
@@ -355,37 +290,17 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.list_workflow_release_tags(
             id="id",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "limit": limit,
-                "offset": offset,
-                "ordering": ordering,
-                "source": source,
-            },
-            request_options=request_options,
+        _response = self._raw_client.list_workflow_release_tags(
+            id, limit=limit, offset=offset, ordering=ordering, source=source, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PaginatedWorkflowReleaseTagReadList,
-                    parse_obj_as(
-                        type_=PaginatedWorkflowReleaseTagReadList,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def retrieve_workflow_release_tag(
         self, id: str, name: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -396,7 +311,7 @@ class WorkflowDeploymentsClient:
         Parameters
         ----------
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         name : str
             The name of the Release Tag associated with this Workflow Deployment that you'd like to retrieve.
@@ -414,6 +329,7 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.retrieve_workflow_release_tag(
@@ -421,25 +337,8 @@ class WorkflowDeploymentsClient:
             name="name",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags/{jsonable_encoder(name)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowReleaseTagRead,
-                    parse_obj_as(
-                        type_=WorkflowReleaseTagRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.retrieve_workflow_release_tag(id, name, request_options=request_options)
+        return _response.data
 
     def update_workflow_release_tag(
         self,
@@ -455,7 +354,7 @@ class WorkflowDeploymentsClient:
         Parameters
         ----------
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         name : str
             The name of the Release Tag associated with this Workflow Deployment that you'd like to update.
@@ -476,6 +375,7 @@ class WorkflowDeploymentsClient:
         from vellum import Vellum
 
         client = Vellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
         client.workflow_deployments.update_workflow_release_tag(
@@ -483,34 +383,117 @@ class WorkflowDeploymentsClient:
             name="name",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags/{jsonable_encoder(name)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="PATCH",
-            json={
-                "history_item_id": history_item_id,
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = self._raw_client.update_workflow_release_tag(
+            id, name, history_item_id=history_item_id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowReleaseTagRead,
-                    parse_obj_as(
-                        type_=WorkflowReleaseTagRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
+
+    def list_workflow_deployment_releases(
+        self,
+        id: str,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PaginatedWorkflowDeploymentReleaseList:
+        """
+        List the Releases of the specified Workflow Deployment for the current Environment.
+
+        Parameters
+        ----------
+        id : str
+            Either the Workflow Deployment's ID or its unique name
+
+        limit : typing.Optional[int]
+            Number of results to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the results.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PaginatedWorkflowDeploymentReleaseList
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+        client.workflow_deployments.list_workflow_deployment_releases(
+            id="id",
+        )
+        """
+        _response = self._raw_client.list_workflow_deployment_releases(
+            id, limit=limit, offset=offset, ordering=ordering, request_options=request_options
+        )
+        return _response.data
+
+    def retrieve_workflow_deployment_release(
+        self, id: str, release_id_or_release_tag: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> WorkflowDeploymentRelease:
+        """
+        Retrieve a specific Workflow Deployment Release by either its UUID or the name of a Release Tag that points to it.
+
+        Parameters
+        ----------
+        id : str
+            Either the Workflow Deployment's ID or its unique name
+
+        release_id_or_release_tag : str
+            Either the UUID of Workflow Deployment Release you'd like to retrieve, or the name of a Release Tag that's pointing to the Workflow Deployment Release you'd like to retrieve.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowDeploymentRelease
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+        client.workflow_deployments.retrieve_workflow_deployment_release(
+            id="id",
+            release_id_or_release_tag="release_id_or_release_tag",
+        )
+        """
+        _response = self._raw_client.retrieve_workflow_deployment_release(
+            id, release_id_or_release_tag, request_options=request_options
+        )
+        return _response.data
 
 
 class AsyncWorkflowDeploymentsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = AsyncRawWorkflowDeploymentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawWorkflowDeploymentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawWorkflowDeploymentsClient
+        """
+        return self._raw_client
 
     async def list(
         self,
@@ -553,6 +536,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -563,31 +547,10 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/workflow-deployments",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "limit": limit,
-                "offset": offset,
-                "ordering": ordering,
-                "status": status,
-            },
-            request_options=request_options,
+        _response = await self._raw_client.list(
+            limit=limit, offset=offset, ordering=ordering, status=status, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PaginatedSlimWorkflowDeploymentList,
-                    parse_obj_as(
-                        type_=PaginatedSlimWorkflowDeploymentList,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     async def retrieve(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -615,6 +578,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -627,25 +591,8 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentRead,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.retrieve(id, request_options=request_options)
+        return _response.data
 
     async def list_workflow_deployment_event_executions(
         self,
@@ -654,6 +601,7 @@ class AsyncWorkflowDeploymentsClient:
         filters: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkflowDeploymentEventExecutionsResponse:
         """
@@ -669,6 +617,8 @@ class AsyncWorkflowDeploymentsClient:
         offset : typing.Optional[int]
             The initial index from which to return the executions.
 
+        ordering : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -684,6 +634,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -696,30 +647,10 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "filters": filters,
-                "limit": limit,
-                "offset": offset,
-            },
-            request_options=request_options,
+        _response = await self._raw_client.list_workflow_deployment_event_executions(
+            id, filters=filters, limit=limit, offset=offset, ordering=ordering, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentEventExecutionsResponse,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentEventExecutionsResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     async def workflow_deployment_event_execution(
         self, execution_id: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -746,6 +677,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -759,31 +691,17 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events/{jsonable_encoder(execution_id)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
+        _response = await self._raw_client.workflow_deployment_event_execution(
+            execution_id, id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowEventExecutionRead,
-                    parse_obj_as(
-                        type_=WorkflowEventExecutionRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     async def workflow_deployment_history_item_retrieve(
         self, history_id_or_release_tag: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> WorkflowDeploymentHistoryItem:
         """
-        Retrieve a specific Workflow Deployment History Item by either its UUID or the name of a Release Tag that points to it.
+        DEPRECATED: This endpoint is deprecated and will be removed in a future release. Please use the
+        `retrieve_workflow_deployment_release` endpoint instead.
 
         Parameters
         ----------
@@ -791,7 +709,7 @@ class AsyncWorkflowDeploymentsClient:
             Either the UUID of Workflow Deployment History Item you'd like to retrieve, or the name of a Release Tag that's pointing to the Workflow Deployment History Item you'd like to retrieve.
 
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -808,6 +726,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -821,25 +740,10 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/history/{jsonable_encoder(history_id_or_release_tag)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
+        _response = await self._raw_client.workflow_deployment_history_item_retrieve(
+            history_id_or_release_tag, id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowDeploymentHistoryItem,
-                    parse_obj_as(
-                        type_=WorkflowDeploymentHistoryItem,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     async def list_workflow_release_tags(
         self,
@@ -885,6 +789,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -897,31 +802,10 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            params={
-                "limit": limit,
-                "offset": offset,
-                "ordering": ordering,
-                "source": source,
-            },
-            request_options=request_options,
+        _response = await self._raw_client.list_workflow_release_tags(
+            id, limit=limit, offset=offset, ordering=ordering, source=source, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PaginatedWorkflowReleaseTagReadList,
-                    parse_obj_as(
-                        type_=PaginatedWorkflowReleaseTagReadList,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     async def retrieve_workflow_release_tag(
         self, id: str, name: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -932,7 +816,7 @@ class AsyncWorkflowDeploymentsClient:
         Parameters
         ----------
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         name : str
             The name of the Release Tag associated with this Workflow Deployment that you'd like to retrieve.
@@ -952,6 +836,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -965,25 +850,8 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags/{jsonable_encoder(name)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowReleaseTagRead,
-                    parse_obj_as(
-                        type_=WorkflowReleaseTagRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.retrieve_workflow_release_tag(id, name, request_options=request_options)
+        return _response.data
 
     async def update_workflow_release_tag(
         self,
@@ -999,7 +867,7 @@ class AsyncWorkflowDeploymentsClient:
         Parameters
         ----------
         id : str
-            A UUID string identifying this workflow deployment.
+            Either the Workflow Deployment's ID or its unique name
 
         name : str
             The name of the Release Tag associated with this Workflow Deployment that you'd like to update.
@@ -1022,6 +890,7 @@ class AsyncWorkflowDeploymentsClient:
         from vellum import AsyncVellum
 
         client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
             api_key="YOUR_API_KEY",
         )
 
@@ -1035,26 +904,114 @@ class AsyncWorkflowDeploymentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/workflow-deployments/{jsonable_encoder(id)}/release-tags/{jsonable_encoder(name)}",
-            base_url=self._client_wrapper.get_environment().default,
-            method="PATCH",
-            json={
-                "history_item_id": history_item_id,
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.update_workflow_release_tag(
+            id, name, history_item_id=history_item_id, request_options=request_options
+        )
+        return _response.data
+
+    async def list_workflow_deployment_releases(
+        self,
+        id: str,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PaginatedWorkflowDeploymentReleaseList:
+        """
+        List the Releases of the specified Workflow Deployment for the current Environment.
+
+        Parameters
+        ----------
+        id : str
+            Either the Workflow Deployment's ID or its unique name
+
+        limit : typing.Optional[int]
+            Number of results to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the results.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PaginatedWorkflowDeploymentReleaseList
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workflow_deployments.list_workflow_deployment_releases(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_workflow_deployment_releases(
+            id, limit=limit, offset=offset, ordering=ordering, request_options=request_options
+        )
+        return _response.data
+
+    async def retrieve_workflow_deployment_release(
+        self, id: str, release_id_or_release_tag: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> WorkflowDeploymentRelease:
+        """
+        Retrieve a specific Workflow Deployment Release by either its UUID or the name of a Release Tag that points to it.
+
+        Parameters
+        ----------
+        id : str
+            Either the Workflow Deployment's ID or its unique name
+
+        release_id_or_release_tag : str
+            Either the UUID of Workflow Deployment Release you'd like to retrieve, or the name of a Release Tag that's pointing to the Workflow Deployment Release you'd like to retrieve.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowDeploymentRelease
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workflow_deployments.retrieve_workflow_deployment_release(
+                id="id",
+                release_id_or_release_tag="release_id_or_release_tag",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.retrieve_workflow_deployment_release(
+            id, release_id_or_release_tag, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    WorkflowReleaseTagRead,
-                    parse_obj_as(
-                        type_=WorkflowReleaseTagRead,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data