# This file was auto-generated by Fern from our API Definition. import typing from json.decoder import JSONDecodeError from ..core.api_error import ApiError from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper from ..core.http_response import AsyncHttpResponse, HttpResponse from ..core.jsonable_encoder import jsonable_encoder from ..core.pydantic_utilities import parse_obj_as from ..core.request_options import RequestOptions from ..core.serialization import convert_and_respect_annotation_metadata from ..errors.bad_request_error import BadRequestError from ..errors.conflict_error import ConflictError from ..errors.not_found_error import NotFoundError from ..errors.unprocessable_entity_error import UnprocessableEntityError from ..types.json_node_write import JsonNodeWrite from ..types.prompt_detail import PromptDetail from ..types.prompt_page_public import PromptPagePublic from ..types.prompt_version_detail import PromptVersionDetail from ..types.prompt_version_link_public import PromptVersionLinkPublic from ..types.prompt_version_page_public import PromptVersionPagePublic from ..types.prompt_version_update import PromptVersionUpdate 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, ...) class RawPromptsClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper def get_prompts( self, *, page: typing.Optional[int] = None, size: typing.Optional[int] = None, name: typing.Optional[str] = None, project_id: typing.Optional[str] = None, sorting: typing.Optional[str] = None, filters: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[PromptPagePublic]: """ Get prompts Parameters ---------- page : typing.Optional[int] size : typing.Optional[int] name : typing.Optional[str] project_id : typing.Optional[str] sorting : typing.Optional[str] filters : typing.Optional[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptPagePublic] OK """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts", method="GET", params={ "page": page, "size": size, "name": name, "project_id": project_id, "sorting": sorting, "filters": filters, }, request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptPagePublic, parse_obj_as( type_=PromptPagePublic, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def create_prompt( self, *, name: str, id: typing.Optional[str] = OMIT, project_id: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, description: typing.Optional[str] = OMIT, template: typing.Optional[str] = OMIT, 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, ) -> HttpResponse[None]: """ Create prompt Parameters ---------- name : str id : typing.Optional[str] project_id : typing.Optional[str] Project ID. Takes precedence over project_name when both are provided. project_name : typing.Optional[str] For project scope, specify either project_id or project_name. If project_name is provided and the project does not exist, it will be created. Ignored when project_id is provided. If neither is provided, the prompt is created at workspace level. description : typing.Optional[str] template : typing.Optional[str] metadata : typing.Optional[JsonNodeWrite] change_description : typing.Optional[str] 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. Returns ------- HttpResponse[None] """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts", method="POST", json={ "id": id, "name": name, "project_id": project_id, "project_name": project_name, "description": description, "template": template, "metadata": metadata, "change_description": change_description, "type": type, "template_structure": template_structure, "tags": tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return HttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def create_prompt_version( self, *, name: str, version: PromptVersionDetail, template_structure: typing.Optional[CreatePromptVersionDetailTemplateStructure] = OMIT, exclude_blueprint_update_for_projects: typing.Optional[typing.Sequence[str]] = OMIT, project_id: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[PromptVersionDetail]: """ Create prompt version Parameters ---------- name : str 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. exclude_blueprint_update_for_projects : typing.Optional[typing.Sequence[str]] Optional set of project IDs to exclude from automatic blueprint creation when this prompt version is committed. project_id : typing.Optional[str] Project ID. Takes precedence over project_name when both are provided. project_name : typing.Optional[str] If provided, scopes the prompt to the specified project. Ignored when project_id is provided. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptVersionDetail] OK """ _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" ), "template_structure": template_structure, "exclude_blueprint_update_for_projects": exclude_blueprint_update_for_projects, "project_id": project_id, "project_name": project_name, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def update_prompt_versions( self, *, ids: typing.Sequence[str], update: PromptVersionUpdate, merge_tags: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[None]: """ 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 ------- HttpResponse[None] """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts/versions", method="PATCH", json={ "ids": ids, "update": convert_and_respect_annotation_metadata( object_=update, annotation=PromptVersionUpdate, direction="write" ), "merge_tags": merge_tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return HttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def get_prompt_by_id( self, id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[PromptDetail]: """ Get prompt by id Parameters ---------- id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptDetail] Prompt resource """ _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: _data = typing.cast( PromptDetail, parse_obj_as( type_=PromptDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 404: raise NotFoundError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def update_prompt( self, id: str, *, name: str, description: typing.Optional[str] = OMIT, tags: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[None]: """ Update prompt Parameters ---------- id : str name : str description : typing.Optional[str] tags : typing.Optional[typing.Sequence[str]] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[None] """ _response = self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(id)}", method="PUT", json={ "name": name, "description": description, "tags": tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return HttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def delete_prompt(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[None]: """ Delete prompt Parameters ---------- id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[None] """ _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 HttpResponse(response=_response, data=None) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def delete_prompts_batch( self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[None]: """ Delete prompts batch Parameters ---------- ids : typing.Sequence[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[None] """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts/delete", method="POST", json={ "ids": ids, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return HttpResponse(response=_response, data=None) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def get_prompt_by_commit( self, commit: str, *, request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[PromptDetail]: """ Get prompt by commit Parameters ---------- commit : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptDetail] OK """ _response = self._client_wrapper.httpx_client.request( f"v1/private/prompts/by-commit/{jsonable_encoder(commit)}", method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptDetail, parse_obj_as( type_=PromptDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def get_prompt_version_by_id( self, version_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[PromptVersionDetail]: """ Get prompt version by id Parameters ---------- version_id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptVersionDetail] Prompt version resource """ _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: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 404: raise NotFoundError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def get_prompt_versions( self, id: str, *, 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, ) -> HttpResponse[PromptVersionPagePublic]: """ Get prompt versions Parameters ---------- id : str page : typing.Optional[int] 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. Returns ------- HttpResponse[PromptVersionPagePublic] OK """ _response = self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(id)}/versions", method="GET", params={ "page": page, "size": size, "search": search, "sorting": sorting, "filters": filters, }, request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionPagePublic, parse_obj_as( type_=PromptVersionPagePublic, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def get_prompts_by_commits( self, *, commits: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[typing.List[PromptVersionLinkPublic]]: """ Get prompts by prompt version commits Parameters ---------- commits : typing.Sequence[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[typing.List[PromptVersionLinkPublic]] OK """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts/retrieve-by-commits", method="POST", json={ "commits": commits, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( typing.List[PromptVersionLinkPublic], parse_obj_as( type_=typing.List[PromptVersionLinkPublic], # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def restore_prompt_version( self, prompt_id: str, version_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[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 ------- HttpResponse[PromptVersionDetail] OK """ _response = self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(prompt_id)}/versions/{jsonable_encoder(version_id)}/restore", method="POST", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def retrieve_prompt_version( self, *, name: str, commit: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[PromptVersionDetail]: """ Retrieve prompt version Parameters ---------- name : str commit : typing.Optional[str] project_name : typing.Optional[str] If provided, scopes the search to the specified project request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[PromptVersionDetail] OK """ _response = self._client_wrapper.httpx_client.request( "v1/private/prompts/versions/retrieve", method="POST", json={ "name": name, "commit": commit, "project_name": project_name, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) class AsyncRawPromptsClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper async def get_prompts( self, *, page: typing.Optional[int] = None, size: typing.Optional[int] = None, name: typing.Optional[str] = None, project_id: typing.Optional[str] = None, sorting: typing.Optional[str] = None, filters: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[PromptPagePublic]: """ Get prompts Parameters ---------- page : typing.Optional[int] size : typing.Optional[int] name : typing.Optional[str] project_id : typing.Optional[str] sorting : typing.Optional[str] filters : typing.Optional[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptPagePublic] OK """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts", method="GET", params={ "page": page, "size": size, "name": name, "project_id": project_id, "sorting": sorting, "filters": filters, }, request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptPagePublic, parse_obj_as( type_=PromptPagePublic, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def create_prompt( self, *, name: str, id: typing.Optional[str] = OMIT, project_id: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, description: typing.Optional[str] = OMIT, template: typing.Optional[str] = OMIT, 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, ) -> AsyncHttpResponse[None]: """ Create prompt Parameters ---------- name : str id : typing.Optional[str] project_id : typing.Optional[str] Project ID. Takes precedence over project_name when both are provided. project_name : typing.Optional[str] For project scope, specify either project_id or project_name. If project_name is provided and the project does not exist, it will be created. Ignored when project_id is provided. If neither is provided, the prompt is created at workspace level. description : typing.Optional[str] template : typing.Optional[str] metadata : typing.Optional[JsonNodeWrite] change_description : typing.Optional[str] 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. Returns ------- AsyncHttpResponse[None] """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts", method="POST", json={ "id": id, "name": name, "project_id": project_id, "project_name": project_name, "description": description, "template": template, "metadata": metadata, "change_description": change_description, "type": type, "template_structure": template_structure, "tags": tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return AsyncHttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def create_prompt_version( self, *, name: str, version: PromptVersionDetail, template_structure: typing.Optional[CreatePromptVersionDetailTemplateStructure] = OMIT, exclude_blueprint_update_for_projects: typing.Optional[typing.Sequence[str]] = OMIT, project_id: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[PromptVersionDetail]: """ Create prompt version Parameters ---------- name : str 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. exclude_blueprint_update_for_projects : typing.Optional[typing.Sequence[str]] Optional set of project IDs to exclude from automatic blueprint creation when this prompt version is committed. project_id : typing.Optional[str] Project ID. Takes precedence over project_name when both are provided. project_name : typing.Optional[str] If provided, scopes the prompt to the specified project. Ignored when project_id is provided. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptVersionDetail] OK """ _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" ), "template_structure": template_structure, "exclude_blueprint_update_for_projects": exclude_blueprint_update_for_projects, "project_id": project_id, "project_name": project_name, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def update_prompt_versions( self, *, ids: typing.Sequence[str], update: PromptVersionUpdate, merge_tags: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[None]: """ 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 ------- AsyncHttpResponse[None] """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts/versions", method="PATCH", json={ "ids": ids, "update": convert_and_respect_annotation_metadata( object_=update, annotation=PromptVersionUpdate, direction="write" ), "merge_tags": merge_tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return AsyncHttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def get_prompt_by_id( self, id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[PromptDetail]: """ Get prompt by id Parameters ---------- id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptDetail] Prompt resource """ _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: _data = typing.cast( PromptDetail, parse_obj_as( type_=PromptDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 404: raise NotFoundError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def update_prompt( self, id: str, *, name: str, description: typing.Optional[str] = OMIT, tags: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[None]: """ Update prompt Parameters ---------- id : str name : str description : typing.Optional[str] tags : typing.Optional[typing.Sequence[str]] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[None] """ _response = await self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(id)}", method="PUT", json={ "name": name, "description": description, "tags": tags, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return AsyncHttpResponse(response=_response, data=None) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def delete_prompt( self, id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[None]: """ Delete prompt Parameters ---------- id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[None] """ _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 AsyncHttpResponse(response=_response, data=None) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def delete_prompts_batch( self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[None]: """ Delete prompts batch Parameters ---------- ids : typing.Sequence[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[None] """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts/delete", method="POST", json={ "ids": ids, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return AsyncHttpResponse(response=_response, data=None) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def get_prompt_by_commit( self, commit: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[PromptDetail]: """ Get prompt by commit Parameters ---------- commit : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptDetail] OK """ _response = await self._client_wrapper.httpx_client.request( f"v1/private/prompts/by-commit/{jsonable_encoder(commit)}", method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptDetail, parse_obj_as( type_=PromptDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def get_prompt_version_by_id( self, version_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[PromptVersionDetail]: """ Get prompt version by id Parameters ---------- version_id : str request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptVersionDetail] Prompt version resource """ _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: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 404: raise NotFoundError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def get_prompt_versions( self, id: str, *, 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, ) -> AsyncHttpResponse[PromptVersionPagePublic]: """ Get prompt versions Parameters ---------- id : str page : typing.Optional[int] 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. Returns ------- AsyncHttpResponse[PromptVersionPagePublic] OK """ _response = await self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(id)}/versions", method="GET", params={ "page": page, "size": size, "search": search, "sorting": sorting, "filters": filters, }, request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionPagePublic, parse_obj_as( type_=PromptVersionPagePublic, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def get_prompts_by_commits( self, *, commits: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[typing.List[PromptVersionLinkPublic]]: """ Get prompts by prompt version commits Parameters ---------- commits : typing.Sequence[str] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[typing.List[PromptVersionLinkPublic]] OK """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts/retrieve-by-commits", method="POST", json={ "commits": commits, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( typing.List[PromptVersionLinkPublic], parse_obj_as( type_=typing.List[PromptVersionLinkPublic], # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def restore_prompt_version( self, prompt_id: str, version_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[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 ------- AsyncHttpResponse[PromptVersionDetail] OK """ _response = await self._client_wrapper.httpx_client.request( f"v1/private/prompts/{jsonable_encoder(prompt_id)}/versions/{jsonable_encoder(version_id)}/restore", method="POST", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def retrieve_prompt_version( self, *, name: str, commit: typing.Optional[str] = OMIT, project_name: typing.Optional[str] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[PromptVersionDetail]: """ Retrieve prompt version Parameters ---------- name : str commit : typing.Optional[str] project_name : typing.Optional[str] If provided, scopes the search to the specified project request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[PromptVersionDetail] OK """ _response = await self._client_wrapper.httpx_client.request( "v1/private/prompts/versions/retrieve", method="POST", json={ "name": name, "commit": commit, "project_name": project_name, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( PromptVersionDetail, parse_obj_as( type_=PromptVersionDetail, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 400: raise BadRequestError( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)