opik 1.6.4__py3-none-any.whl → 1.9.71__py3-none-any.whl

opik/rest_api/prompts/client.py

@@ -1,24 +1,19 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ..core.client_wrapper import SyncClientWrapper
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
-from ..types.prompt_page_public import PromptPagePublic
-from ..core.pydantic_utilities import parse_obj_as
-from json.decoder import JSONDecodeError
-from ..core.api_error import ApiError
 from ..types.json_node_write import JsonNodeWrite
-from .types.prompt_write_type import PromptWriteType
-from ..errors.bad_request_error import BadRequestError
-from ..errors.conflict_error import ConflictError
-from ..errors.unprocessable_entity_error import UnprocessableEntityError
-from ..types.prompt_version_detail import PromptVersionDetail
-from ..core.serialization import convert_and_respect_annotation_metadata
 from ..types.prompt_detail import PromptDetail
-from ..core.jsonable_encoder import jsonable_encoder
-from ..errors.not_found_error import NotFoundError
+from ..types.prompt_page_public import PromptPagePublic
+from ..types.prompt_version_detail import PromptVersionDetail
 from ..types.prompt_version_page_public import PromptVersionPagePublic
-from ..core.client_wrapper import AsyncClientWrapper
+from ..types.prompt_version_update import PromptVersionUpdate
+from .raw_client import AsyncRawPromptsClient, RawPromptsClient
+from .types.create_prompt_version_detail_template_structure import CreatePromptVersionDetailTemplateStructure
+from .types.prompt_write_template_structure import PromptWriteTemplateStructure
+from .types.prompt_write_type import PromptWriteType
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -26,7 +21,18 @@ OMIT = typing.cast(typing.Any, ...)
 
 class PromptsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = RawPromptsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawPromptsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawPromptsClient
+        """
+        return self._raw_client
 
     def get_prompts(
         self,
@@ -34,6 +40,8 @@ class PromptsClient:
         page: typing.Optional[int] = None,
         size: typing.Optional[int] = None,
         name: typing.Optional[str] = None,
+        sorting: typing.Optional[str] = None,
+        filters: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptPagePublic:
         """
@@ -47,6 +55,10 @@ class PromptsClient:
 
         name : typing.Optional[str]
 
+        sorting : typing.Optional[str]
+
+        filters : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -58,36 +70,13 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         client.prompts.get_prompts()
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/private/prompts",
-            method="GET",
-            params={
-                "page": page,
-                "size": size,
-                "name": name,
-            },
-            request_options=request_options,
+        _response = self._raw_client.get_prompts(
+            page=page, size=size, name=name, sorting=sorting, filters=filters, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptPagePublic,
-                    parse_obj_as(
-                        type_=PromptPagePublic,  # 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 create_prompt(
         self,
@@ -99,6 +88,8 @@ class PromptsClient:
         metadata: typing.Optional[JsonNodeWrite] = OMIT,
         change_description: typing.Optional[str] = OMIT,
         type: typing.Optional[PromptWriteType] = OMIT,
+        template_structure: typing.Optional[PromptWriteTemplateStructure] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> None:
         """
@@ -120,6 +111,11 @@ class PromptsClient:
 
         type : typing.Optional[PromptWriteType]
 
+        template_structure : typing.Optional[PromptWriteTemplateStructure]
+            Template structure type: 'text' or 'chat'. Immutable after creation.
+
+        tags : typing.Optional[typing.Sequence[str]]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -130,76 +126,29 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.create_prompt(
-            name="name",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/private/prompts",
-            method="POST",
-            json={
-                "id": id,
-                "name": name,
-                "description": description,
-                "template": template,
-                "metadata": metadata,
-                "change_description": change_description,
-                "type": type,
-            },
-            headers={
-                "content-type": "application/json",
-            },
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.create_prompt(name='name', )
+        """
+        _response = self._raw_client.create_prompt(
+            name=name,
+            id=id,
+            description=description,
+            template=template,
+            metadata=metadata,
+            change_description=change_description,
+            type=type,
+            template_structure=template_structure,
+            tags=tags,
             request_options=request_options,
-            omit=OMIT,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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 create_prompt_version(
         self,
         *,
         name: str,
         version: PromptVersionDetail,
+        template_structure: typing.Optional[CreatePromptVersionDetailTemplateStructure] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptVersionDetail:
         """
@@ -211,6 +160,9 @@ class PromptsClient:
 
         version : PromptVersionDetail
 
+        template_structure : typing.Optional[CreatePromptVersionDetailTemplateStructure]
+            Template structure for the prompt: 'text' or 'chat'. Note: This field is only used when creating a new prompt. If a prompt with the given name already exists, this field is ignored and the existing prompt's template structure is used. Template structure is immutable after prompt creation.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -221,81 +173,68 @@ class PromptsClient:
 
         Examples
         --------
-        from Opik import OpikApi, PromptVersionDetail
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.create_prompt_version(
-            name="name",
-            version=PromptVersionDetail(
-                template="template",
-            ),
+        from Opik import OpikApi
+        from Opik import PromptVersionDetail
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.create_prompt_version(name='name', version=PromptVersionDetail(template='template', ), )
+        """
+        _response = self._raw_client.create_prompt_version(
+            name=name, version=version, template_structure=template_structure, request_options=request_options
         )
+        return _response.data
+
+    def update_prompt_versions(
+        self,
+        *,
+        ids: typing.Sequence[str],
+        update: PromptVersionUpdate,
+        merge_tags: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/versions",
-            method="POST",
-            json={
-                "name": name,
-                "version": convert_and_respect_annotation_metadata(
-                    object_=version, annotation=PromptVersionDetail, direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        Update one or more prompt versions.
+
+        Note: Prompt versions are immutable by design.
+        Only organizational properties, such as tags etc., can be updated.
+        Core properties like template and metadata cannot be modified after creation.
+
+        PATCH semantics:
+        - non-empty values update the field
+        - null values preserve existing field values (no change)
+        - empty values explicitly clear the field
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            IDs of prompt versions to update
+
+        update : PromptVersionUpdate
+
+        merge_tags : typing.Optional[bool]
+            Tag merge behavior:
+            - true: Add new tags to existing tags (union)
+            - false: Replace all existing tags with new tags (default behaviour if not provided)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from Opik import OpikApi
+        from Opik import PromptVersionUpdate
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.update_prompt_versions(ids=['ids'], update=PromptVersionUpdate(), )
+        """
+        _response = self._raw_client.update_prompt_versions(
+            ids=ids, update=update, merge_tags=merge_tags, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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)
-
-    def get_prompt_by_id(
-        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> PromptDetail:
+        return _response.data
+
+    def get_prompt_by_id(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> PromptDetail:
         """
         Get prompt by id
 
@@ -314,43 +253,11 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.get_prompt_by_id(
-            id="id",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.get_prompt_by_id(id='id', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptDetail,
-                    parse_obj_as(
-                        type_=PromptDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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.get_prompt_by_id(id, request_options=request_options)
+        return _response.data
 
     def update_prompt(
         self,
@@ -358,6 +265,7 @@ class PromptsClient:
         *,
         name: str,
         description: typing.Optional[str] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> None:
         """
@@ -371,6 +279,8 @@ class PromptsClient:
 
         description : typing.Optional[str]
 
+        tags : typing.Optional[typing.Sequence[str]]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -381,80 +291,15 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.update_prompt(
-            id="id",
-            name="name",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.update_prompt(id='id', name='name', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="PUT",
-            json={
-                "name": name,
-                "description": description,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = self._raw_client.update_prompt(
+            id, name=name, description=description, tags=tags, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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)
-
-    def delete_prompt(
-        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
+        return _response.data
+
+    def delete_prompt(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         Delete prompt
 
@@ -472,33 +317,14 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.delete_prompt(
-            id="id",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.delete_prompt(id='id', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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.delete_prompt(id, request_options=request_options)
+        return _response.data
 
     def delete_prompts_batch(
-        self,
-        *,
-        ids: typing.Sequence[str],
-        request_options: typing.Optional[RequestOptions] = None,
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
     ) -> None:
         """
         Delete prompts batch
@@ -517,37 +343,14 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.delete_prompts_batch(
-            ids=["ids"],
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.delete_prompts_batch(ids=['ids'], )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/delete",
-            method="POST",
-            json={
-                "ids": ids,
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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.delete_prompts_batch(ids=ids, request_options=request_options)
+        return _response.data
 
     def get_prompt_version_by_id(
-        self,
-        version_id: str,
-        *,
-        request_options: typing.Optional[RequestOptions] = None,
+        self, version_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> PromptVersionDetail:
         """
         Get prompt version by id
@@ -567,43 +370,11 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.get_prompt_version_by_id(
-            version_id="versionId",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.get_prompt_version_by_id(version_id='versionId', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/versions/{jsonable_encoder(version_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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.get_prompt_version_by_id(version_id, request_options=request_options)
+        return _response.data
 
     def get_prompt_versions(
         self,
@@ -611,6 +382,9 @@ class PromptsClient:
         *,
         page: typing.Optional[int] = None,
         size: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        sorting: typing.Optional[str] = None,
+        filters: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptVersionPagePublic:
         """
@@ -624,6 +398,13 @@ class PromptsClient:
 
         size : typing.Optional[int]
 
+        search : typing.Optional[str]
+            Search text to find in template or change description fields
+
+        sorting : typing.Optional[str]
+
+        filters : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -635,44 +416,45 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.get_prompt_versions(
-            id="id",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.get_prompt_versions(id='id', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}/versions",
-            method="GET",
-            params={
-                "page": page,
-                "size": size,
-            },
-            request_options=request_options,
+        _response = self._raw_client.get_prompt_versions(
+            id, page=page, size=size, search=search, sorting=sorting, filters=filters, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionPagePublic,
-                    parse_obj_as(
-                        type_=PromptVersionPagePublic,  # 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 restore_prompt_version(
+        self, prompt_id: str, version_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> PromptVersionDetail:
+        """
+        Restore a prompt version by creating a new version with the content from the specified version
+
+        Parameters
+        ----------
+        prompt_id : str
+
+        version_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PromptVersionDetail
+            OK
+
+        Examples
+        --------
+        from Opik import OpikApi
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.restore_prompt_version(prompt_id='promptId', version_id='versionId', )
+        """
+        _response = self._raw_client.restore_prompt_version(prompt_id, version_id, request_options=request_options)
+        return _response.data
 
     def retrieve_prompt_version(
-        self,
-        *,
-        name: str,
-        commit: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
+        self, *, name: str, commit: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None
     ) -> PromptVersionDetail:
         """
         Retrieve prompt version
@@ -694,76 +476,27 @@ class PromptsClient:
         Examples
         --------
         from Opik import OpikApi
-
-        client = OpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-        client.prompts.retrieve_prompt_version(
-            name="name",
-        )
+        client = OpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        client.prompts.retrieve_prompt_version(name='name', )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/versions/retrieve",
-            method="POST",
-            json={
-                "name": name,
-                "commit": commit,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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_prompt_version(name=name, commit=commit, request_options=request_options)
+        return _response.data
 
 
 class AsyncPromptsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = AsyncRawPromptsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawPromptsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawPromptsClient
+        """
+        return self._raw_client
 
     async def get_prompts(
         self,
@@ -771,6 +504,8 @@ class AsyncPromptsClient:
         page: typing.Optional[int] = None,
         size: typing.Optional[int] = None,
         name: typing.Optional[str] = None,
+        sorting: typing.Optional[str] = None,
+        filters: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptPagePublic:
         """
@@ -784,6 +519,10 @@ class AsyncPromptsClient:
 
         name : typing.Optional[str]
 
+        sorting : typing.Optional[str]
+
+        filters : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -794,45 +533,17 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
             await client.prompts.get_prompts()
-
-
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/private/prompts",
-            method="GET",
-            params={
-                "page": page,
-                "size": size,
-                "name": name,
-            },
-            request_options=request_options,
+        _response = await self._raw_client.get_prompts(
+            page=page, size=size, name=name, sorting=sorting, filters=filters, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptPagePublic,
-                    parse_obj_as(
-                        type_=PromptPagePublic,  # 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 create_prompt(
         self,
@@ -844,6 +555,8 @@ class AsyncPromptsClient:
         metadata: typing.Optional[JsonNodeWrite] = OMIT,
         change_description: typing.Optional[str] = OMIT,
         type: typing.Optional[PromptWriteType] = OMIT,
+        template_structure: typing.Optional[PromptWriteTemplateStructure] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> None:
         """
@@ -865,6 +578,11 @@ class AsyncPromptsClient:
 
         type : typing.Optional[PromptWriteType]
 
+        template_structure : typing.Optional[PromptWriteTemplateStructure]
+            Template structure type: 'text' or 'chat'. Immutable after creation.
+
+        tags : typing.Optional[typing.Sequence[str]]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -874,85 +592,33 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.create_prompt(
-                name="name",
-            )
-
-
+            await client.prompts.create_prompt(name='name', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/private/prompts",
-            method="POST",
-            json={
-                "id": id,
-                "name": name,
-                "description": description,
-                "template": template,
-                "metadata": metadata,
-                "change_description": change_description,
-                "type": type,
-            },
-            headers={
-                "content-type": "application/json",
-            },
+        _response = await self._raw_client.create_prompt(
+            name=name,
+            id=id,
+            description=description,
+            template=template,
+            metadata=metadata,
+            change_description=change_description,
+            type=type,
+            template_structure=template_structure,
+            tags=tags,
             request_options=request_options,
-            omit=OMIT,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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 create_prompt_version(
         self,
         *,
         name: str,
         version: PromptVersionDetail,
+        template_structure: typing.Optional[CreatePromptVersionDetailTemplateStructure] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptVersionDetail:
         """
@@ -964,6 +630,9 @@ class AsyncPromptsClient:
 
         version : PromptVersionDetail
 
+        template_structure : typing.Optional[CreatePromptVersionDetailTemplateStructure]
+            Template structure for the prompt: 'text' or 'chat'. Note: This field is only used when creating a new prompt. If a prompt with the given name already exists, this field is ignored and the existing prompt's template structure is used. Template structure is immutable after prompt creation.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -974,85 +643,72 @@ class AsyncPromptsClient:
 
         Examples
         --------
+        from Opik import AsyncOpikApi
+        from Opik import PromptVersionDetail
         import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        async def main() -> None:
+            await client.prompts.create_prompt_version(name='name', version=PromptVersionDetail(template='template', ), )
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_prompt_version(
+            name=name, version=version, template_structure=template_structure, request_options=request_options
+        )
+        return _response.data
+
+    async def update_prompt_versions(
+        self,
+        *,
+        ids: typing.Sequence[str],
+        update: PromptVersionUpdate,
+        merge_tags: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
+        """
+        Update one or more prompt versions.
 
-        from Opik import AsyncOpikApi, PromptVersionDetail
+        Note: Prompt versions are immutable by design.
+        Only organizational properties, such as tags etc., can be updated.
+        Core properties like template and metadata cannot be modified after creation.
 
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
+        PATCH semantics:
+        - non-empty values update the field
+        - null values preserve existing field values (no change)
+        - empty values explicitly clear the field
 
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            IDs of prompt versions to update
 
-        async def main() -> None:
-            await client.prompts.create_prompt_version(
-                name="name",
-                version=PromptVersionDetail(
-                    template="template",
-                ),
-            )
+        update : PromptVersionUpdate
 
+        merge_tags : typing.Optional[bool]
+            Tag merge behavior:
+            - true: Add new tags to existing tags (union)
+            - false: Replace all existing tags with new tags (default behaviour if not provided)
 
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from Opik import AsyncOpikApi
+        from Opik import PromptVersionUpdate
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        async def main() -> None:
+            await client.prompts.update_prompt_versions(ids=['ids'], update=PromptVersionUpdate(), )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/versions",
-            method="POST",
-            json={
-                "name": name,
-                "version": convert_and_respect_annotation_metadata(
-                    object_=version, annotation=PromptVersionDetail, direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.update_prompt_versions(
+            ids=ids, update=update, merge_tags=merge_tags, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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 get_prompt_by_id(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
@@ -1074,52 +730,15 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.get_prompt_by_id(
-                id="id",
-            )
-
-
+            await client.prompts.get_prompt_by_id(id='id', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptDetail,
-                    parse_obj_as(
-                        type_=PromptDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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.get_prompt_by_id(id, request_options=request_options)
+        return _response.data
 
     async def update_prompt(
         self,
@@ -1127,6 +746,7 @@ class AsyncPromptsClient:
         *,
         name: str,
         description: typing.Optional[str] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> None:
         """
@@ -1140,6 +760,8 @@ class AsyncPromptsClient:
 
         description : typing.Optional[str]
 
+        tags : typing.Optional[typing.Sequence[str]]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1149,89 +771,19 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.update_prompt(
-                id="id",
-                name="name",
-            )
-
-
+            await client.prompts.update_prompt(id='id', name='name', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="PUT",
-            json={
-                "name": name,
-                "description": description,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.update_prompt(
+            id, name=name, description=description, tags=tags, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 409:
-                raise ConflictError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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)
-
-    async def delete_prompt(
-        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
+        return _response.data
+
+    async def delete_prompt(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         Delete prompt
 
@@ -1248,42 +800,18 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.delete_prompt(
-                id="id",
-            )
-
-
+            await client.prompts.delete_prompt(id='id', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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.delete_prompt(id, request_options=request_options)
+        return _response.data
 
     async def delete_prompts_batch(
-        self,
-        *,
-        ids: typing.Sequence[str],
-        request_options: typing.Optional[RequestOptions] = None,
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
     ) -> None:
         """
         Delete prompts batch
@@ -1301,46 +829,18 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.delete_prompts_batch(
-                ids=["ids"],
-            )
-
-
+            await client.prompts.delete_prompts_batch(ids=['ids'], )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/delete",
-            method="POST",
-            json={
-                "ids": ids,
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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.delete_prompts_batch(ids=ids, request_options=request_options)
+        return _response.data
 
     async def get_prompt_version_by_id(
-        self,
-        version_id: str,
-        *,
-        request_options: typing.Optional[RequestOptions] = None,
+        self, version_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> PromptVersionDetail:
         """
         Get prompt version by id
@@ -1359,52 +859,15 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.get_prompt_version_by_id(
-                version_id="versionId",
-            )
-
-
+            await client.prompts.get_prompt_version_by_id(version_id='versionId', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/versions/{jsonable_encoder(version_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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.get_prompt_version_by_id(version_id, request_options=request_options)
+        return _response.data
 
     async def get_prompt_versions(
         self,
@@ -1412,6 +875,9 @@ class AsyncPromptsClient:
         *,
         page: typing.Optional[int] = None,
         size: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        sorting: typing.Optional[str] = None,
+        filters: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PromptVersionPagePublic:
         """
@@ -1425,6 +891,13 @@ class AsyncPromptsClient:
 
         size : typing.Optional[int]
 
+        search : typing.Optional[str]
+            Search text to find in template or change description fields
+
+        sorting : typing.Optional[str]
+
+        filters : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1435,53 +908,54 @@ class AsyncPromptsClient:
 
         Examples
         --------
+        from Opik import AsyncOpikApi
         import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        async def main() -> None:
+            await client.prompts.get_prompt_versions(id='id', )
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_prompt_versions(
+            id, page=page, size=size, search=search, sorting=sorting, filters=filters, request_options=request_options
+        )
+        return _response.data
 
-        from Opik import AsyncOpikApi
+    async def restore_prompt_version(
+        self, prompt_id: str, version_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> PromptVersionDetail:
+        """
+        Restore a prompt version by creating a new version with the content from the specified version
 
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
+        Parameters
+        ----------
+        prompt_id : str
 
+        version_id : str
 
-        async def main() -> None:
-            await client.prompts.get_prompt_versions(
-                id="id",
-            )
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
 
+        Returns
+        -------
+        PromptVersionDetail
+            OK
 
+        Examples
+        --------
+        from Opik import AsyncOpikApi
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
+        async def main() -> None:
+            await client.prompts.restore_prompt_version(prompt_id='promptId', version_id='versionId', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/private/prompts/{jsonable_encoder(id)}/versions",
-            method="GET",
-            params={
-                "page": page,
-                "size": size,
-            },
-            request_options=request_options,
+        _response = await self._raw_client.restore_prompt_version(
+            prompt_id, version_id, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionPagePublic,
-                    parse_obj_as(
-                        type_=PromptVersionPagePublic,  # 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_prompt_version(
-        self,
-        *,
-        name: str,
-        commit: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
+        self, *, name: str, commit: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None
     ) -> PromptVersionDetail:
         """
         Retrieve prompt version
@@ -1502,77 +976,14 @@ class AsyncPromptsClient:
 
         Examples
         --------
-        import asyncio
-
         from Opik import AsyncOpikApi
-
-        client = AsyncOpikApi(
-            api_key="YOUR_API_KEY",
-            workspace_name="YOUR_WORKSPACE_NAME",
-        )
-
-
+        import asyncio
+        client = AsyncOpikApi(api_key="YOUR_API_KEY", workspace_name="YOUR_WORKSPACE_NAME", )
         async def main() -> None:
-            await client.prompts.retrieve_prompt_version(
-                name="name",
-            )
-
-
+            await client.prompts.retrieve_prompt_version(name='name', )
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/private/prompts/versions/retrieve",
-            method="POST",
-            json={
-                "name": name,
-                "commit": commit,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.retrieve_prompt_version(
+            name=name, commit=commit, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    PromptVersionDetail,
-                    parse_obj_as(
-                        type_=PromptVersionDetail,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 404:
-                raise NotFoundError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # 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