wavix-python-sdk 1.0.0__py3-none-any.whl

wavix/numbers/raw_client.py

@@ -0,0 +1,1000 @@
+# 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 encode_path_param
+from ..core.parse_error import ParsingError
+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.forbidden_error import ForbiddenError
+from ..errors.not_found_error import NotFoundError
+from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.number import Number
+from ..types.number_destination import NumberDestination
+from ..types.number_list_response import NumberListResponse
+from .types.bulk_update_numbers_response import BulkUpdateNumbersResponse
+from .types.delete_numbers_response import DeleteNumbersResponse
+from pydantic import ValidationError
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawNumbersClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        *,
+        city_id: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        label: typing.Optional[str] = None,
+        label_present: typing.Optional[bool] = None,
+        page: typing.Optional[int] = None,
+        per_page: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[NumberListResponse]:
+        """
+        Returns a paginated list of the phone numbers owned by the authenticated account.
+
+        Parameters
+        ----------
+        city_id : typing.Optional[int]
+            Filters numbers by the ID of their city or rate center.
+
+        search : typing.Optional[str]
+            Filters numbers by a full or partial phone number.
+
+        label : typing.Optional[str]
+            Filters numbers by `label`.
+
+        label_present : typing.Optional[bool]
+            When `true`, returns only numbers that have a label; when `false`, only numbers without one.
+
+        page : typing.Optional[int]
+            Page number to retrieve. Default `1`.
+
+        per_page : typing.Optional[int]
+            Number of records to return per page. Default `25`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[NumberListResponse]
+            Returns a paginated list of phone numbers.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="GET",
+            params={
+                "city_id": city_id,
+                "search": search,
+                "label": label,
+                "label_present": label_present,
+                "page": page,
+                "per_page": per_page,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    NumberListResponse,
+                    parse_obj_as(
+                        type_=NumberListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def delete(
+        self,
+        *,
+        ids: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        dids: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[DeleteNumbersResponse]:
+        """
+        Releases the listed phone numbers back to stock. Selection accepts either `ids` (record IDs) or `dids` (phone numbers), but not both.
+
+        Parameters
+        ----------
+        ids : typing.Optional[typing.Union[int, typing.Sequence[int]]]
+            Record IDs of the phone numbers to release. Mutually exclusive with `dids`.
+
+        dids : typing.Optional[str]
+            Comma-separated phone numbers to release. Mutually exclusive with `ids`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[DeleteNumbersResponse]
+            Returns a success confirmation. The numbers are released back to stock.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="DELETE",
+            params={
+                "ids": ids,
+                "dids": dids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DeleteNumbersResponse,
+                    parse_obj_as(
+                        type_=DeleteNumbersResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def bulk_update(
+        self,
+        *,
+        ids: typing.Sequence[int],
+        sms_enabled: typing.Optional[bool] = OMIT,
+        destinations: typing.Optional[typing.Sequence[NumberDestination]] = OMIT,
+        sms_relay_url: typing.Optional[str] = OMIT,
+        call_recording_enabled: typing.Optional[bool] = OMIT,
+        transcription_enabled: typing.Optional[bool] = OMIT,
+        transcription_threshold: typing.Optional[int] = OMIT,
+        call_status_url: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[BulkUpdateNumbersResponse]:
+        """
+        Applies the same changes to every listed phone number. Only the provided fields are changed. Destination and SMS callback changes are applied asynchronously and may not be reflected in the response immediately.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[int]
+            Numbers (by ID) to apply the patch to. The same patch is
+            applied to every listed number.
+
+        sms_enabled : typing.Optional[bool]
+            Indicates whether SMS is enabled for the phone numbers.
+
+        destinations : typing.Optional[typing.Sequence[NumberDestination]]
+            Inbound call routing destinations for the phone numbers.
+
+        sms_relay_url : typing.Optional[str]
+            Callback URL for inbound messages.
+
+        call_recording_enabled : typing.Optional[bool]
+            Indicates whether call recording is enabled.
+
+        transcription_enabled : typing.Optional[bool]
+            Indicates whether call transcription is enabled.
+
+        transcription_threshold : typing.Optional[int]
+            Minimum call duration in seconds before transcription runs.
+
+        call_status_url : typing.Optional[str]
+            Callback URL for call status updates.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[BulkUpdateNumbersResponse]
+            Returns the updated phone numbers.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="PATCH",
+            json={
+                "ids": ids,
+                "sms_enabled": sms_enabled,
+                "destinations": convert_and_respect_annotation_metadata(
+                    object_=destinations, annotation=typing.Sequence[NumberDestination], direction="write"
+                ),
+                "sms_relay_url": sms_relay_url,
+                "call_recording_enabled": call_recording_enabled,
+                "transcription_enabled": transcription_enabled,
+                "transcription_threshold": transcription_threshold,
+                "call_status_url": call_status_url,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    BulkUpdateNumbersResponse,
+                    parse_obj_as(
+                        type_=BulkUpdateNumbersResponse,  # 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.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[Number]:
+        """
+        Returns the phone number identified by `id`, including its destinations, documents, and feature settings.
+
+        Parameters
+        ----------
+        id : int
+            The unique ID of the phone number.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Number]
+            Returns the phone number.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/numbers/{encode_path_param(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Number,
+                    parse_obj_as(
+                        type_=Number,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def update(
+        self,
+        id: int,
+        *,
+        sms_enabled: typing.Optional[bool] = OMIT,
+        destinations: typing.Optional[typing.Sequence[NumberDestination]] = OMIT,
+        sms_relay_url: typing.Optional[str] = OMIT,
+        call_recording_enabled: typing.Optional[bool] = OMIT,
+        transcription_enabled: typing.Optional[bool] = OMIT,
+        transcription_threshold: typing.Optional[int] = OMIT,
+        call_status_url: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[Number]:
+        """
+        Updates the phone number identified by `id`. Only the provided fields are changed.
+
+        Parameters
+        ----------
+        id : int
+            The unique ID of the phone number.
+
+        sms_enabled : typing.Optional[bool]
+            Indicates whether SMS is enabled for the phone number.
+
+        destinations : typing.Optional[typing.Sequence[NumberDestination]]
+            Inbound call routing destinations for the phone number.
+
+        sms_relay_url : typing.Optional[str]
+            Callback URL for inbound messages.
+
+        call_recording_enabled : typing.Optional[bool]
+            Indicates whether call recording is enabled.
+
+        transcription_enabled : typing.Optional[bool]
+            Indicates whether call transcription is enabled.
+
+        transcription_threshold : typing.Optional[int]
+            Minimum call duration in seconds before transcription runs.
+
+        call_status_url : typing.Optional[str]
+            Callback URL for call status updates.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Number]
+            Returns the updated phone number.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/numbers/{encode_path_param(id)}",
+            method="PATCH",
+            json={
+                "sms_enabled": sms_enabled,
+                "destinations": convert_and_respect_annotation_metadata(
+                    object_=destinations, annotation=typing.Sequence[NumberDestination], direction="write"
+                ),
+                "sms_relay_url": sms_relay_url,
+                "call_recording_enabled": call_recording_enabled,
+                "transcription_enabled": transcription_enabled,
+                "transcription_threshold": transcription_threshold,
+                "call_status_url": call_status_url,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Number,
+                    parse_obj_as(
+                        type_=Number,  # 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.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawNumbersClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        city_id: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        label: typing.Optional[str] = None,
+        label_present: typing.Optional[bool] = None,
+        page: typing.Optional[int] = None,
+        per_page: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[NumberListResponse]:
+        """
+        Returns a paginated list of the phone numbers owned by the authenticated account.
+
+        Parameters
+        ----------
+        city_id : typing.Optional[int]
+            Filters numbers by the ID of their city or rate center.
+
+        search : typing.Optional[str]
+            Filters numbers by a full or partial phone number.
+
+        label : typing.Optional[str]
+            Filters numbers by `label`.
+
+        label_present : typing.Optional[bool]
+            When `true`, returns only numbers that have a label; when `false`, only numbers without one.
+
+        page : typing.Optional[int]
+            Page number to retrieve. Default `1`.
+
+        per_page : typing.Optional[int]
+            Number of records to return per page. Default `25`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[NumberListResponse]
+            Returns a paginated list of phone numbers.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="GET",
+            params={
+                "city_id": city_id,
+                "search": search,
+                "label": label,
+                "label_present": label_present,
+                "page": page,
+                "per_page": per_page,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    NumberListResponse,
+                    parse_obj_as(
+                        type_=NumberListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def delete(
+        self,
+        *,
+        ids: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        dids: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[DeleteNumbersResponse]:
+        """
+        Releases the listed phone numbers back to stock. Selection accepts either `ids` (record IDs) or `dids` (phone numbers), but not both.
+
+        Parameters
+        ----------
+        ids : typing.Optional[typing.Union[int, typing.Sequence[int]]]
+            Record IDs of the phone numbers to release. Mutually exclusive with `dids`.
+
+        dids : typing.Optional[str]
+            Comma-separated phone numbers to release. Mutually exclusive with `ids`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[DeleteNumbersResponse]
+            Returns a success confirmation. The numbers are released back to stock.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="DELETE",
+            params={
+                "ids": ids,
+                "dids": dids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DeleteNumbersResponse,
+                    parse_obj_as(
+                        type_=DeleteNumbersResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def bulk_update(
+        self,
+        *,
+        ids: typing.Sequence[int],
+        sms_enabled: typing.Optional[bool] = OMIT,
+        destinations: typing.Optional[typing.Sequence[NumberDestination]] = OMIT,
+        sms_relay_url: typing.Optional[str] = OMIT,
+        call_recording_enabled: typing.Optional[bool] = OMIT,
+        transcription_enabled: typing.Optional[bool] = OMIT,
+        transcription_threshold: typing.Optional[int] = OMIT,
+        call_status_url: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[BulkUpdateNumbersResponse]:
+        """
+        Applies the same changes to every listed phone number. Only the provided fields are changed. Destination and SMS callback changes are applied asynchronously and may not be reflected in the response immediately.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[int]
+            Numbers (by ID) to apply the patch to. The same patch is
+            applied to every listed number.
+
+        sms_enabled : typing.Optional[bool]
+            Indicates whether SMS is enabled for the phone numbers.
+
+        destinations : typing.Optional[typing.Sequence[NumberDestination]]
+            Inbound call routing destinations for the phone numbers.
+
+        sms_relay_url : typing.Optional[str]
+            Callback URL for inbound messages.
+
+        call_recording_enabled : typing.Optional[bool]
+            Indicates whether call recording is enabled.
+
+        transcription_enabled : typing.Optional[bool]
+            Indicates whether call transcription is enabled.
+
+        transcription_threshold : typing.Optional[int]
+            Minimum call duration in seconds before transcription runs.
+
+        call_status_url : typing.Optional[str]
+            Callback URL for call status updates.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[BulkUpdateNumbersResponse]
+            Returns the updated phone numbers.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/numbers",
+            method="PATCH",
+            json={
+                "ids": ids,
+                "sms_enabled": sms_enabled,
+                "destinations": convert_and_respect_annotation_metadata(
+                    object_=destinations, annotation=typing.Sequence[NumberDestination], direction="write"
+                ),
+                "sms_relay_url": sms_relay_url,
+                "call_recording_enabled": call_recording_enabled,
+                "transcription_enabled": transcription_enabled,
+                "transcription_threshold": transcription_threshold,
+                "call_status_url": call_status_url,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    BulkUpdateNumbersResponse,
+                    parse_obj_as(
+                        type_=BulkUpdateNumbersResponse,  # 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.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get(
+        self, id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[Number]:
+        """
+        Returns the phone number identified by `id`, including its destinations, documents, and feature settings.
+
+        Parameters
+        ----------
+        id : int
+            The unique ID of the phone number.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Number]
+            Returns the phone number.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/numbers/{encode_path_param(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Number,
+                    parse_obj_as(
+                        type_=Number,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def update(
+        self,
+        id: int,
+        *,
+        sms_enabled: typing.Optional[bool] = OMIT,
+        destinations: typing.Optional[typing.Sequence[NumberDestination]] = OMIT,
+        sms_relay_url: typing.Optional[str] = OMIT,
+        call_recording_enabled: typing.Optional[bool] = OMIT,
+        transcription_enabled: typing.Optional[bool] = OMIT,
+        transcription_threshold: typing.Optional[int] = OMIT,
+        call_status_url: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[Number]:
+        """
+        Updates the phone number identified by `id`. Only the provided fields are changed.
+
+        Parameters
+        ----------
+        id : int
+            The unique ID of the phone number.
+
+        sms_enabled : typing.Optional[bool]
+            Indicates whether SMS is enabled for the phone number.
+
+        destinations : typing.Optional[typing.Sequence[NumberDestination]]
+            Inbound call routing destinations for the phone number.
+
+        sms_relay_url : typing.Optional[str]
+            Callback URL for inbound messages.
+
+        call_recording_enabled : typing.Optional[bool]
+            Indicates whether call recording is enabled.
+
+        transcription_enabled : typing.Optional[bool]
+            Indicates whether call transcription is enabled.
+
+        transcription_threshold : typing.Optional[int]
+            Minimum call duration in seconds before transcription runs.
+
+        call_status_url : typing.Optional[str]
+            Callback URL for call status updates.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Number]
+            Returns the updated phone number.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/numbers/{encode_path_param(id)}",
+            method="PATCH",
+            json={
+                "sms_enabled": sms_enabled,
+                "destinations": convert_and_respect_annotation_metadata(
+                    object_=destinations, annotation=typing.Sequence[NumberDestination], direction="write"
+                ),
+                "sms_relay_url": sms_relay_url,
+                "call_recording_enabled": call_recording_enabled,
+                "transcription_enabled": transcription_enabled,
+                "transcription_threshold": transcription_threshold,
+                "call_status_url": call_status_url,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Number,
+                    parse_obj_as(
+                        type_=Number,  # 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.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=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)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)