telnyx 3.0.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

telnyx/resources/oauth_grants.py

@@ -17,7 +17,7 @@ from .._response import (
 )
 from .._base_client import make_request_options
 from ..types.oauth_grant_list_response import OAuthGrantListResponse
-from ..types.oauth_grant_delete_response import OAuthGrantDeleteResponse
+from ..types.oauth_grant_revoke_response import OAuthGrantRevokeResponse
 from ..types.oauth_grant_retrieve_response import OAuthGrantRetrieveResponse
 
 __all__ = ["OAuthGrantsResource", "AsyncOAuthGrantsResource"]
@@ -122,7 +122,7 @@ class OAuthGrantsResource(SyncAPIResource):
             cast_to=OAuthGrantListResponse,
         )
 
-    def delete(
+    def revoke(
         self,
         id: str,
         *,
@@ -132,7 +132,7 @@ class OAuthGrantsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthGrantDeleteResponse:
+    ) -> OAuthGrantRevokeResponse:
         """
         Revoke an OAuth grant
 
@@ -152,7 +152,7 @@ class OAuthGrantsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthGrantDeleteResponse,
+            cast_to=OAuthGrantRevokeResponse,
         )
 
 
@@ -255,7 +255,7 @@ class AsyncOAuthGrantsResource(AsyncAPIResource):
             cast_to=OAuthGrantListResponse,
         )
 
-    async def delete(
+    async def revoke(
         self,
         id: str,
         *,
@@ -265,7 +265,7 @@ class AsyncOAuthGrantsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthGrantDeleteResponse:
+    ) -> OAuthGrantRevokeResponse:
         """
         Revoke an OAuth grant
 
@@ -285,7 +285,7 @@ class AsyncOAuthGrantsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthGrantDeleteResponse,
+            cast_to=OAuthGrantRevokeResponse,
         )
 
 
@@ -299,8 +299,8 @@ class OAuthGrantsResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             oauth_grants.list,
         )
-        self.delete = to_raw_response_wrapper(
-            oauth_grants.delete,
+        self.revoke = to_raw_response_wrapper(
+            oauth_grants.revoke,
         )
 
 
@@ -314,8 +314,8 @@ class AsyncOAuthGrantsResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             oauth_grants.list,
         )
-        self.delete = async_to_raw_response_wrapper(
-            oauth_grants.delete,
+        self.revoke = async_to_raw_response_wrapper(
+            oauth_grants.revoke,
         )
 
 
@@ -329,8 +329,8 @@ class OAuthGrantsResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             oauth_grants.list,
         )
-        self.delete = to_streamed_response_wrapper(
-            oauth_grants.delete,
+        self.revoke = to_streamed_response_wrapper(
+            oauth_grants.revoke,
         )
 
 
@@ -344,6 +344,6 @@ class AsyncOAuthGrantsResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             oauth_grants.list,
         )
-        self.delete = async_to_streamed_response_wrapper(
-            oauth_grants.delete,
+        self.revoke = async_to_streamed_response_wrapper(
+            oauth_grants.revoke,
         )

telnyx/resources/verified_numbers/verified_numbers.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Literal
 
 import httpx
@@ -62,6 +63,7 @@ class VerifiedNumbersResource(SyncAPIResource):
         *,
         phone_number: str,
         verification_method: Literal["sms", "call"],
+        extension: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -69,12 +71,20 @@ class VerifiedNumbersResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> VerifiedNumberCreateResponse:
-        """
-        Initiates phone number verification procedure.
+        """Initiates phone number verification procedure.
+
+        Supports DTMF extension dialing
+        for voice calls to numbers behind IVR systems.
 
         Args:
           verification_method: Verification method.
 
+          extension: Optional DTMF extension sequence to dial after the call is answered. This
+              parameter enables verification of phone numbers behind IVR systems that require
+              extension dialing. Valid characters: digits 0-9, letters A-D, symbols \\** and #.
+              Pauses: w = 0.5 second pause, W = 1 second pause. Maximum length: 50 characters.
+              Only works with 'call' verification method.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -89,6 +99,7 @@ class VerifiedNumbersResource(SyncAPIResource):
                 {
                     "phone_number": phone_number,
                     "verification_method": verification_method,
+                    "extension": extension,
                 },
                 verified_number_create_params.VerifiedNumberCreateParams,
             ),
@@ -236,6 +247,7 @@ class AsyncVerifiedNumbersResource(AsyncAPIResource):
         *,
         phone_number: str,
         verification_method: Literal["sms", "call"],
+        extension: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -243,12 +255,20 @@ class AsyncVerifiedNumbersResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> VerifiedNumberCreateResponse:
-        """
-        Initiates phone number verification procedure.
+        """Initiates phone number verification procedure.
+
+        Supports DTMF extension dialing
+        for voice calls to numbers behind IVR systems.
 
         Args:
           verification_method: Verification method.
 
+          extension: Optional DTMF extension sequence to dial after the call is answered. This
+              parameter enables verification of phone numbers behind IVR systems that require
+              extension dialing. Valid characters: digits 0-9, letters A-D, symbols \\** and #.
+              Pauses: w = 0.5 second pause, W = 1 second pause. Maximum length: 50 characters.
+              Only works with 'call' verification method.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -263,6 +283,7 @@ class AsyncVerifiedNumbersResource(AsyncAPIResource):
                 {
                     "phone_number": phone_number,
                     "verification_method": verification_method,
+                    "extension": extension,
                 },
                 verified_number_create_params.VerifiedNumberCreateParams,
             ),

telnyx/types/__init__.py

@@ -8,6 +8,7 @@ from .ip import IP as IP
 from .fax import Fax as Fax
 from .fqdn import Fqdn as Fqdn
 from .room import Room as Room
+from .error import Error as Error
 from .record import Record as Record
 from .shared import (
     Metadata as Metadata,
@@ -29,7 +30,6 @@ from .shared import (
 from .address import Address as Address
 from .sim_card import SimCard as SimCard
 from .vertical import Vertical as Vertical
-from .api_error import APIError as APIError
 from .dtmf_type import DtmfType as DtmfType
 from .interface import Interface as Interface
 from .rcs_agent import RcsAgent as RcsAgent
@@ -112,7 +112,6 @@ from .ip_delete_response import IPDeleteResponse as IPDeleteResponse
 from .ip_update_response import IPUpdateResponse as IPUpdateResponse
 from .number_block_order import NumberBlockOrder as NumberBlockOrder
 from .number_reservation import NumberReservation as NumberReservation
-from .oauth_token_params import OAuthTokenParams as OAuthTokenParams
 from .porting_order_misc import PortingOrderMisc as PortingOrderMisc
 from .porting_order_type import PortingOrderType as PortingOrderType
 from .rcs_agent_response import RcsAgentResponse as RcsAgentResponse
@@ -139,7 +138,6 @@ from .media_upload_params import MediaUploadParams as MediaUploadParams
 from .message_send_params import MessageSendParams as MessageSendParams
 from .messsage_rcs_params import MesssageRcsParams as MesssageRcsParams
 from .network_list_params import NetworkListParams as NetworkListParams
-from .oauth_grants_params import OAuthGrantsParams as OAuthGrantsParams
 from .outbound_fqdn_param import OutboundFqdnParam as OutboundFqdnParam
 from .portout_list_params import PortoutListParams as PortoutListParams
 from .telnyx_campaign_csp import TelnyxCampaignCsp as TelnyxCampaignCsp
@@ -158,7 +156,6 @@ from .notification_channel import NotificationChannel as NotificationChannel
 from .notification_profile import NotificationProfile as NotificationProfile
 from .notification_setting import NotificationSetting as NotificationSetting
 from .number_pool_settings import NumberPoolSettings as NumberPoolSettings
-from .oauth_token_response import OAuthTokenResponse as OAuthTokenResponse
 from .rcs_suggestion_param import RcsSuggestionParam as RcsSuggestionParam
 from .region_list_response import RegionListResponse as RegionListResponse
 from .room_create_response import RoomCreateResponse as RoomCreateResponse
@@ -181,8 +178,6 @@ from .credential_connection import CredentialConnection as CredentialConnection
 from .fax_retrieve_response import FaxRetrieveResponse as FaxRetrieveResponse
 from .global_ip_list_params import GlobalIPListParams as GlobalIPListParams
 from .invoice_list_response import InvoiceListResponse as InvoiceListResponse
-from .list_buckets_response import ListBucketsResponse as ListBucketsResponse
-from .list_objects_response import ListObjectsResponse as ListObjectsResponse
 from .media_update_response import MediaUpdateResponse as MediaUpdateResponse
 from .media_upload_response import MediaUploadResponse as MediaUploadResponse
 from .message_send_response import MessageSendResponse as MessageSendResponse
@@ -190,8 +185,6 @@ from .messsage_rcs_response import MesssageRcsResponse as MesssageRcsResponse
 from .network_create_params import NetworkCreateParams as NetworkCreateParams
 from .network_list_response import NetworkListResponse as NetworkListResponse
 from .network_update_params import NetworkUpdateParams as NetworkUpdateParams
-from .oauth_grants_response import OAuthGrantsResponse as OAuthGrantsResponse
-from .oauth_register_params import OAuthRegisterParams as OAuthRegisterParams
 from .phone_number_campaign import PhoneNumberCampaign as PhoneNumberCampaign
 from .phone_number_detailed import PhoneNumberDetailed as PhoneNumberDetailed
 from .portout_list_response import PortoutListResponse as PortoutListResponse
@@ -210,6 +203,7 @@ from .document_upload_params import DocumentUploadParams as DocumentUploadParams
 from .enum_retrieve_response import EnumRetrieveResponse as EnumRetrieveResponse
 from .fqdn_retrieve_response import FqdnRetrieveResponse as FqdnRetrieveResponse
 from .gcs_configuration_data import GcsConfigurationData as GcsConfigurationData
+from .oauth_authorize_params import OAuthAuthorizeParams as OAuthAuthorizeParams
 from .ota_update_list_params import OtaUpdateListParams as OtaUpdateListParams
 from .outbound_voice_profile import OutboundVoiceProfile as OutboundVoiceProfile
 from .porting_order_end_user import PortingOrderEndUser as PortingOrderEndUser
@@ -243,9 +237,6 @@ from .network_create_response import NetworkCreateResponse as NetworkCreateRespo
 from .network_delete_response import NetworkDeleteResponse as NetworkDeleteResponse
 from .network_update_response import NetworkUpdateResponse as NetworkUpdateResponse
 from .oauth_grant_list_params import OAuthGrantListParams as OAuthGrantListParams
-from .oauth_introspect_params import OAuthIntrospectParams as OAuthIntrospectParams
-from .oauth_register_response import OAuthRegisterResponse as OAuthRegisterResponse
-from .oauth_retrieve_response import OAuthRetrieveResponse as OAuthRetrieveResponse
 from .outbound_call_recording import OutboundCallRecording as OutboundCallRecording
 from .porting_order_documents import PortingOrderDocuments as PortingOrderDocuments
 from .porting_order_messaging import PortingOrderMessaging as PortingOrderMessaging
@@ -261,8 +252,6 @@ from .azure_configuration_data import AzureConfigurationData as AzureConfigurati
 from .call_control_application import CallControlApplication as CallControlApplication
 from .call_event_list_response import CallEventListResponse as CallEventListResponse
 from .channel_zone_list_params import ChannelZoneListParams as ChannelZoneListParams
-from .client_get_object_params import ClientGetObjectParams as ClientGetObjectParams
-from .client_put_object_params import ClientPutObjectParams as ClientPutObjectParams
 from .conference_create_params import ConferenceCreateParams as ConferenceCreateParams
 from .conference_list_response import ConferenceListResponse as ConferenceListResponse
 from .connection_list_response import ConnectionListResponse as ConnectionListResponse
@@ -306,8 +295,8 @@ from .message_retrieve_response import MessageRetrieveResponse as MessageRetriev
 from .message_schedule_response import MessageScheduleResponse as MessageScheduleResponse
 from .network_retrieve_response import NetworkRetrieveResponse as NetworkRetrieveResponse
 from .number_order_phone_number import NumberOrderPhoneNumber as NumberOrderPhoneNumber
+from .oauth_create_grant_params import OAuthCreateGrantParams as OAuthCreateGrantParams
 from .oauth_grant_list_response import OAuthGrantListResponse as OAuthGrantListResponse
-from .oauth_introspect_response import OAuthIntrospectResponse as OAuthIntrospectResponse
 from .porting_order_list_params import PortingOrderListParams as PortingOrderListParams
 from .porting_order_requirement import PortingOrderRequirement as PortingOrderRequirement
 from .portout_retrieve_response import PortoutRetrieveResponse as PortoutRetrieveResponse
@@ -321,7 +310,6 @@ from .access_ip_address_response import AccessIPAddressResponse as AccessIPAddre
 from .call_bridged_webhook_event import CallBridgedWebhookEvent as CallBridgedWebhookEvent
 from .channel_zone_list_response import ChannelZoneListResponse as ChannelZoneListResponse
 from .channel_zone_update_params import ChannelZoneUpdateParams as ChannelZoneUpdateParams
-from .client_list_objects_params import ClientListObjectsParams as ClientListObjectsParams
 from .conference_create_response import ConferenceCreateResponse as ConferenceCreateResponse
 from .document_retrieve_response import DocumentRetrieveResponse as DocumentRetrieveResponse
 from .dynamic_emergency_endpoint import DynamicEmergencyEndpoint as DynamicEmergencyEndpoint
@@ -356,7 +344,6 @@ from .billing_group_update_params import BillingGroupUpdateParams as BillingGrou
 from .brand_get_feedback_response import BrandGetFeedbackResponse as BrandGetFeedbackResponse
 from .call_answered_webhook_event import CallAnsweredWebhookEvent as CallAnsweredWebhookEvent
 from .call_enqueued_webhook_event import CallEnqueuedWebhookEvent as CallEnqueuedWebhookEvent
-from .client_create_bucket_params import ClientCreateBucketParams as ClientCreateBucketParams
 from .detail_record_list_response import DetailRecordListResponse as DetailRecordListResponse
 from .document_link_list_response import DocumentLinkListResponse as DocumentLinkListResponse
 from .fax_application_list_params import FaxApplicationListParams as FaxApplicationListParams
@@ -368,7 +355,9 @@ from .ip_connection_list_response import IPConnectionListResponse as IPConnectio
 from .ip_connection_update_params import IPConnectionUpdateParams as IPConnectionUpdateParams
 from .ledger_billing_group_report import LedgerBillingGroupReport as LedgerBillingGroupReport
 from .managed_account_list_params import ManagedAccountListParams as ManagedAccountListParams
-from .oauth_grant_delete_response import OAuthGrantDeleteResponse as OAuthGrantDeleteResponse
+from .oauth_create_grant_response import OAuthCreateGrantResponse as OAuthCreateGrantResponse
+from .oauth_exchange_token_params import OAuthExchangeTokenParams as OAuthExchangeTokenParams
+from .oauth_grant_revoke_response import OAuthGrantRevokeResponse as OAuthGrantRevokeResponse
 from .porting_order_create_params import PortingOrderCreateParams as PortingOrderCreateParams
 from .porting_order_list_response import PortingOrderListResponse as PortingOrderListResponse
 from .porting_order_update_params import PortingOrderUpdateParams as PortingOrderUpdateParams
@@ -383,7 +372,6 @@ from .advanced_order_update_params import AdvancedOrderUpdateParams as AdvancedO
 from .call_initiated_webhook_event import CallInitiatedWebhookEvent as CallInitiatedWebhookEvent
 from .campaign_deactivate_response import CampaignDeactivateResponse as CampaignDeactivateResponse
 from .channel_zone_update_response import ChannelZoneUpdateResponse as ChannelZoneUpdateResponse
-from .client_delete_objects_params import ClientDeleteObjectsParams as ClientDeleteObjectsParams
 from .conference_retrieve_response import ConferenceRetrieveResponse as ConferenceRetrieveResponse
 from .connection_retrieve_response import ConnectionRetrieveResponse as ConnectionRetrieveResponse
 from .create_verification_response import CreateVerificationResponse as CreateVerificationResponse
@@ -395,6 +383,7 @@ from .number_order_create_response import NumberOrderCreateResponse as NumberOrd
 from .number_order_update_response import NumberOrderUpdateResponse as NumberOrderUpdateResponse
 from .oauth_client_create_response import OAuthClientCreateResponse as OAuthClientCreateResponse
 from .oauth_client_update_response import OAuthClientUpdateResponse as OAuthClientUpdateResponse
+from .oauth_register_client_params import OAuthRegisterClientParams as OAuthRegisterClientParams
 from .oauth_retrieve_jwks_response import OAuthRetrieveJwksResponse as OAuthRetrieveJwksResponse
 from .ota_update_retrieve_response import OtaUpdateRetrieveResponse as OtaUpdateRetrieveResponse
 from .partner_campaign_list_params import PartnerCampaignListParams as PartnerCampaignListParams
@@ -456,7 +445,9 @@ from .message_send_long_code_params import MessageSendLongCodeParams as MessageS
 from .messaging_profile_list_params import MessagingProfileListParams as MessagingProfileListParams
 from .number_lookup_retrieve_params import NumberLookupRetrieveParams as NumberLookupRetrieveParams
 from .numbers_feature_create_params import NumbersFeatureCreateParams as NumbersFeatureCreateParams
+from .oauth_exchange_token_response import OAuthExchangeTokenResponse as OAuthExchangeTokenResponse
 from .oauth_grant_retrieve_response import OAuthGrantRetrieveResponse as OAuthGrantRetrieveResponse
+from .oauth_introspect_token_params import OAuthIntrospectTokenParams as OAuthIntrospectTokenParams
 from .outbound_call_recording_param import OutboundCallRecordingParam as OutboundCallRecordingParam
 from .phone_number_slim_list_params import PhoneNumberSlimListParams as PhoneNumberSlimListParams
 from .porting_order_create_response import PortingOrderCreateResponse as PortingOrderCreateResponse
@@ -486,6 +477,7 @@ from .number_block_order_list_params import NumberBlockOrderListParams as Number
 from .number_order_retrieve_response import NumberOrderRetrieveResponse as NumberOrderRetrieveResponse
 from .number_reservation_list_params import NumberReservationListParams as NumberReservationListParams
 from .oauth_client_retrieve_response import OAuthClientRetrieveResponse as OAuthClientRetrieveResponse
+from .oauth_register_client_response import OAuthRegisterClientResponse as OAuthRegisterClientResponse
 from .partner_campaign_list_response import PartnerCampaignListResponse as PartnerCampaignListResponse
 from .partner_campaign_update_params import PartnerCampaignUpdateParams as PartnerCampaignUpdateParams
 from .phone_number_retrieve_response import PhoneNumberRetrieveResponse as PhoneNumberRetrieveResponse
@@ -543,7 +535,8 @@ from .messaging_profile_update_params import MessagingProfileUpdateParams as Mes
 from .number_lookup_retrieve_response import NumberLookupRetrieveResponse as NumberLookupRetrieveResponse
 from .number_order_with_phone_numbers import NumberOrderWithPhoneNumbers as NumberOrderWithPhoneNumbers
 from .numbers_feature_create_response import NumbersFeatureCreateResponse as NumbersFeatureCreateResponse
-from .oauth_retrieve_authorize_params import OAuthRetrieveAuthorizeParams as OAuthRetrieveAuthorizeParams
+from .oauth_introspect_token_response import OAuthIntrospectTokenResponse as OAuthIntrospectTokenResponse
+from .oauth_retrieve_consent_response import OAuthRetrieveConsentResponse as OAuthRetrieveConsentResponse
 from .phone_number_slim_list_response import PhoneNumberSlimListResponse as PhoneNumberSlimListResponse
 from .porting_order_end_user_location import PortingOrderEndUserLocation as PortingOrderEndUserLocation
 from .porting_order_retrieve_response import PortingOrderRetrieveResponse as PortingOrderRetrieveResponse

telnyx/types/addresses/action_validate_response.py

@@ -5,8 +5,8 @@ from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
+from ..error import Error
 from ..._models import BaseModel
-from ..api_error import APIError
 
 __all__ = ["ActionValidateResponse", "Data", "DataSuggested"]
 
@@ -39,12 +39,17 @@ class DataSuggested(BaseModel):
     street_address: Optional[str] = None
     """The primary street address information about the address."""
 
-    __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
     if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
         # Stub to indicate that arbitrary properties are accepted.
         # To access properties that are not valid identifiers you can use `getattr`, e.g.
         # `getattr(obj, '$type')`
         def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]
 
 
 class Data(BaseModel):
@@ -54,7 +59,7 @@ class Data(BaseModel):
     suggested: DataSuggested
     """Provides normalized address when available."""
 
-    errors: Optional[List[APIError]] = None
+    errors: Optional[List[Error]] = None
 
     record_type: Optional[str] = None
     """Identifies the type of the resource."""

telnyx/types/ai/inference_embedding_transfer_tool_params.py

@@ -41,3 +41,9 @@ class InferenceEmbeddingTransferToolParams(BaseModel):
 
     custom_headers: Optional[List[CustomHeader]] = None
     """Custom headers to be added to the SIP INVITE for the transfer command."""
+
+    warm_transfer_instructions: Optional[str] = None
+    """
+    Natural language instructions for your agent for how to provide context for the
+    transfer recipient.
+    """

telnyx/types/ai/inference_embedding_transfer_tool_params_param.py

@@ -48,3 +48,9 @@ class InferenceEmbeddingTransferToolParamsParam(
 
     custom_headers: Iterable[CustomHeader]
     """Custom headers to be added to the SIP INVITE for the transfer command."""
+
+    warm_transfer_instructions: str
+    """
+    Natural language instructions for your agent for how to provide context for the
+    transfer recipient.
+    """

telnyx/types/ai/voice_settings.py

@@ -1,10 +1,50 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Union, Optional
+from typing_extensions import Literal, TypeAlias
 
 from ..._models import BaseModel
 
-__all__ = ["VoiceSettings"]
+__all__ = [
+    "VoiceSettings",
+    "BackgroundAudio",
+    "BackgroundAudioUnionMember0",
+    "BackgroundAudioUnionMember1",
+    "BackgroundAudioUnionMember2",
+]
+
+
+class BackgroundAudioUnionMember0(BaseModel):
+    type: Literal["predefined_media"]
+    """Select from predefined media options."""
+
+    value: Literal["silence", "office"]
+    """The predefined media to use. `silence` disables background audio."""
+
+
+class BackgroundAudioUnionMember1(BaseModel):
+    type: Literal["media_url"]
+    """Provide a direct URL to an MP3 file. The audio will loop during the call."""
+
+    value: str
+    """HTTPS URL to an MP3 file."""
+
+
+class BackgroundAudioUnionMember2(BaseModel):
+    type: Literal["media_name"]
+    """Reference a previously uploaded media by its name from Telnyx Media Storage."""
+
+    value: str
+    """
+    The `name` of a media asset created via
+    [Media Storage API](https://developers.telnyx.com/api/media-storage/create-media-storage).
+    The audio will loop during the call.
+    """
+
+
+BackgroundAudio: TypeAlias = Union[
+    BackgroundAudioUnionMember0, BackgroundAudioUnionMember1, BackgroundAudioUnionMember2
+]
 
 
 class VoiceSettings(BaseModel):
@@ -28,6 +68,13 @@ class VoiceSettings(BaseModel):
     with this integration.
     """
 
+    background_audio: Optional[BackgroundAudio] = None
+    """Optional background audio to play on the call.
+
+    Use a predefined media bed, or supply a looped MP3 URL. If a media URL is chosen
+    in the portal, customers can preview it before saving.
+    """
+
     voice_speed: Optional[float] = None
     """The speed of the voice in the range [0.25, 2.0].
 

telnyx/types/ai/voice_settings_param.py

@@ -2,9 +2,49 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing import Union
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
-__all__ = ["VoiceSettingsParam"]
+__all__ = [
+    "VoiceSettingsParam",
+    "BackgroundAudio",
+    "BackgroundAudioUnionMember0",
+    "BackgroundAudioUnionMember1",
+    "BackgroundAudioUnionMember2",
+]
+
+
+class BackgroundAudioUnionMember0(TypedDict, total=False):
+    type: Required[Literal["predefined_media"]]
+    """Select from predefined media options."""
+
+    value: Required[Literal["silence", "office"]]
+    """The predefined media to use. `silence` disables background audio."""
+
+
+class BackgroundAudioUnionMember1(TypedDict, total=False):
+    type: Required[Literal["media_url"]]
+    """Provide a direct URL to an MP3 file. The audio will loop during the call."""
+
+    value: Required[str]
+    """HTTPS URL to an MP3 file."""
+
+
+class BackgroundAudioUnionMember2(TypedDict, total=False):
+    type: Required[Literal["media_name"]]
+    """Reference a previously uploaded media by its name from Telnyx Media Storage."""
+
+    value: Required[str]
+    """
+    The `name` of a media asset created via
+    [Media Storage API](https://developers.telnyx.com/api/media-storage/create-media-storage).
+    The audio will loop during the call.
+    """
+
+
+BackgroundAudio: TypeAlias = Union[
+    BackgroundAudioUnionMember0, BackgroundAudioUnionMember1, BackgroundAudioUnionMember2
+]
 
 
 class VoiceSettingsParam(TypedDict, total=False):
@@ -28,6 +68,13 @@ class VoiceSettingsParam(TypedDict, total=False):
     with this integration.
     """
 
+    background_audio: BackgroundAudio
+    """Optional background audio to play on the call.
+
+    Use a predefined media bed, or supply a looped MP3 URL. If a media URL is chosen
+    in the portal, customers can preview it before saving.
+    """
+
     voice_speed: float
     """The speed of the voice in the range [0.25, 2.0].
 

telnyx/types/brand_create_params.py

@@ -31,7 +31,8 @@ class BrandCreateParams(TypedDict, total=False):
     business_contact_email: Annotated[str, PropertyInfo(alias="businessContactEmail")]
     """Business contact email.
 
-    Required if `entityType` is `PUBLIC_PROFIT`.
+    Required if `entityType` is `PUBLIC_PROFIT`. Otherwise, it is recommended to
+    either omit this field or set it to `null`.
     """
 
     city: str

telnyx/types/brand_update_params.py

@@ -39,7 +39,8 @@ class BrandUpdateParams(TypedDict, total=False):
     business_contact_email: Annotated[str, PropertyInfo(alias="businessContactEmail")]
     """Business contact email.
 
-    Required if `entityType` will be changed to `PUBLIC_PROFIT`.
+    Required if `entityType` will be changed to `PUBLIC_PROFIT`. Otherwise, it is
+    recommended to either omit this field or set it to `null`.
     """
 
     city: str

telnyx/types/call_dial_params.py

@@ -139,6 +139,14 @@ class CallDialParams(TypedDict, total=False):
     WAV or MP3 file.
     """
 
+    park_after_unbridge: str
+    """If supplied with the value `self`, the current leg will be parked after
+    unbridge.
+
+    If not set, the default behavior is to hang up the leg. When park_after_unbridge
+    is set, link_to becomes required.
+    """
+
     preferred_codecs: str
     """
     The list of comma-separated codecs in a preferred order for the forked media to

telnyx/types/country_coverage_retrieve_country_response.py

@@ -10,6 +10,8 @@ __all__ = ["CountryCoverageRetrieveCountryResponse", "Data", "DataLocal", "DataT
 class DataLocal(BaseModel):
     features: Optional[List[str]] = None
 
+    full_pstn_replacement: Optional[bool] = None
+
     international_sms: Optional[bool] = None
 
     p2p: Optional[bool] = None
@@ -22,6 +24,8 @@ class DataLocal(BaseModel):
 class DataTollFree(BaseModel):
     features: Optional[List[str]] = None
 
+    full_pstn_replacement: Optional[bool] = None
+
     international_sms: Optional[bool] = None
 
     p2p: Optional[bool] = None
@@ -59,6 +63,9 @@ class Data(BaseModel):
     quickship: Optional[bool] = None
     """Supports quickship"""
 
+    region: Optional[str] = None
+    """Geographic region (e.g., AMER, EMEA, APAC)"""
+
     reservable: Optional[bool] = None
     """Supports reservable"""
 

telnyx/types/country_coverage_retrieve_response.py

@@ -10,6 +10,8 @@ __all__ = ["CountryCoverageRetrieveResponse", "Data", "DataLocal", "DataTollFree
 class DataLocal(BaseModel):
     features: Optional[List[str]] = None
 
+    full_pstn_replacement: Optional[bool] = None
+
     international_sms: Optional[bool] = None
 
     p2p: Optional[bool] = None
@@ -22,6 +24,8 @@ class DataLocal(BaseModel):
 class DataTollFree(BaseModel):
     features: Optional[List[str]] = None
 
+    full_pstn_replacement: Optional[bool] = None
+
     international_sms: Optional[bool] = None
 
     p2p: Optional[bool] = None
@@ -59,6 +63,9 @@ class Data(BaseModel):
     quickship: Optional[bool] = None
     """Supports quickship"""
 
+    region: Optional[str] = None
+    """Geographic region (e.g., AMER, EMEA, APAC)"""
+
     reservable: Optional[bool] = None
     """Supports reservable"""
 

telnyx/types/{api_error.py → error.py}

@@ -4,7 +4,7 @@ from typing import Dict, Optional
 
 from .._models import BaseModel
 
-__all__ = ["APIError", "Source"]
+__all__ = ["Error", "Source"]
 
 
 class Source(BaseModel):
@@ -15,7 +15,7 @@ class Source(BaseModel):
     """JSON pointer (RFC6901) to the offending entity."""
 
 
-class APIError(BaseModel):
+class Error(BaseModel):
     code: str
 
     title: str

telnyx/types/{oauth_retrieve_authorize_params.py → oauth_authorize_params.py}

@@ -4,10 +4,10 @@ from __future__ import annotations
 
 from typing_extensions import Literal, Required, TypedDict
 
-__all__ = ["OAuthRetrieveAuthorizeParams"]
+__all__ = ["OAuthAuthorizeParams"]
 
 
-class OAuthRetrieveAuthorizeParams(TypedDict, total=False):
+class OAuthAuthorizeParams(TypedDict, total=False):
     client_id: Required[str]
     """OAuth client identifier"""