Merge branch 'main' into snyk-fix-ae4ac38fefde26335928ee53bb0962de

Author: manisha1997

.github/workflows/test-and-deploy.yml

@@ -47,6 +47,7 @@ jobs:
           TWILIO_FROM_NUMBER: ${{ secrets.TWILIO_FROM_NUMBER }}
           TWILIO_TO_NUMBER: ${{ secrets.TWILIO_TO_NUMBER }}
           TWILIO_AUTH_TOKEN: ${{ secrets.TWILIO_AUTH_TOKEN }}
+          ASSISTANT_ID: ${{ secrets.ASSISTANT_ID }}
         run: make cluster-test
 
       - name: Verify docs generation

CHANGES.md

@@ -3,6 +3,80 @@ twilio-python Changelog
 
 Here you can see the full list of changes between each twilio-python release.
 
+[2025-03-11] Version 9.5.0
+--------------------------
+**Library - Feature**
+- [PR #850](https://github.com/twilio/twilio-python/pull/850): Update UPGRADE.md. Thanks to [@manisha1997](https://github.com/manisha1997)!
+
+**Library - Fix**
+- [PR #847](https://github.com/twilio/twilio-python/pull/847): AssistantsBase import. Thanks to [@sbansla](https://github.com/sbansla)!
+
+**Api**
+- Add the missing `emergency_enabled` field for `Address Service` endpoints
+
+**Messaging**
+- Add missing enums for A2P and TF
+
+**Numbers**
+- add missing enum values to hosted_number_order_status
+
+**Twiml**
+- Convert Twiml Attribute `speechModel` of type enum to string **(breaking change)**
+
+
+[2025-02-20] Version 9.4.6
+--------------------------
+**Library - Chore**
+- [PR #842](https://github.com/twilio/twilio-python/pull/842): issue 841. Thanks to [@manisha1997](https://github.com/manisha1997)!
+
+**Flex**
+- Adding Digital Transfers APIs under v1/Interactions
+
+**Numbers**
+- Convert webhook_type to ienum type in v1/Porting/Configuration/Webhook/{webhook_type}
+
+**Trusthub**
+- Changing TrustHub SupportingDocument status enum from lowercase to uppercase since kyc-orch returns status capitalized and rest proxy requires strict casing
+
+
+[2025-02-11] Version 9.4.5
+--------------------------
+**Api**
+- Change downstream url and change media type for file `base/api/v2010/validation_request.json`.
+
+**Intelligence**
+- Add json_results for Generative JSON operator results
+
+**Messaging**
+- Add DestinationAlphaSender API to support Country-Specific Alpha Senders
+
+**Video**
+- Change codec type from enum to case-insensitive enum in recording and room_recording apis
+
+
+[2025-01-28] Version 9.4.4
+--------------------------
+**Library - Fix**
+- [PR #822](https://github.com/twilio/twilio-python/pull/822): Fix for 10 vulnerabilities. Thanks to [@twilio-product-security](https://github.com/twilio-product-security)!
+
+**Library - Chore**
+- [PR #834](https://github.com/twilio/twilio-python/pull/834): update httpclient. Thanks to [@manisha1997](https://github.com/manisha1997)!
+- [PR #837](https://github.com/twilio/twilio-python/pull/837): enable newer versions of aiohttp-retry. Thanks to [@tiwarishubham635](https://github.com/tiwarishubham635)!
+- [PR #833](https://github.com/twilio/twilio-python/pull/833): created bug report issue template. Thanks to [@sbansla](https://github.com/sbansla)!
+
+**Api**
+- Add open-api file tag to `conference/call recordings` and `recording_transcriptions`.
+
+**Events**
+- Add support for subaccount subscriptions (beta)
+
+**Insights**
+- add new region to conference APIs
+
+**Lookups**
+- Add new `parnter_sub_id` query parameter to the lookup request
+
+
 [2025-01-13] Version 9.4.3
 --------------------------
 **Messaging**

README.md

@@ -135,7 +135,9 @@ client = Client()
 
 ### Specify Region and/or Edge
 
-To take advantage of Twilio's [Global Infrastructure](https://www.twilio.com/docs/global-infrastructure), specify the target Region and/or Edge for the client:
+To take advantage of Twilio's [Global Infrastructure](https://www.twilio.com/docs/global-infrastructure), specify the target Region and Edge for the client:
+
+> **Note:** When specifying a `region` parameter for a helper library client, be sure to also specify the `edge` parameter. For backward compatibility purposes, specifying a `region` without specifying an `edge` will result in requests being routed to US1.
 
 ```python
 from twilio.rest import Client

setup.py

@@ -13,7 +13,7 @@
 
 setup(
     name="twilio",
-    version="9.4.3",
+    version="9.5.0",
     description="Twilio API client and TwiML generator",
     author="Twilio",
     help_center="https://www.twilio.com/help/contact",

tests/cluster/test_cluster.py

@@ -12,6 +12,7 @@ def setUp(self):
         self.api_key = os.environ["TWILIO_API_KEY"]
         self.api_secret = os.environ["TWILIO_API_SECRET"]
         self.account_sid = os.environ["TWILIO_ACCOUNT_SID"]
+        self.assistant_id = os.environ["ASSISTANT_ID"]
         self.client = Client(
             username=self.api_key,
             password=self.api_secret,
@@ -65,6 +66,11 @@ def test_list_available_numbers(self):
         self.assertIsNotNone(toll_free_numbers)
         self.assertEqual(len(toll_free_numbers), 2)
 
+    def test_fetch_assistant(self):
+        assistant = self.client.assistants.v1.assistants(self.assistant_id).fetch()
+        self.assertIsNotNone(assistant)
+        self.assertEqual(assistant.account_sid, self.account_sid)
+
     def test_calling_twiml_string(self):
         call = self.client.calls.create(
             to=self.to_number, from_=self.from_number, twiml=str(self.voice_twiml)

tests/unit/http/test_http_client.py

@@ -293,7 +293,6 @@ def test_session_not_preserved(self):
         self.assertEqual(response_2.content, "response_2")
 
 
-
 class MyVersion(Version):
     def __init__(self, domain):
         super().__init__(domain, "v1")

twilio/__init__.py

@@ -1,2 +1,2 @@
-__version_info__ = ("9", "4", "3")
+__version_info__ = ("9", "5", "0")
 __version__ = ".".join(__version_info__)

twilio/rest/api/v2010/account/address/__init__.py

@@ -148,7 +148,7 @@ def update(
         """
         Update the AddressInstance
 
-        :param friendly_name: A descriptive string that you create to describe the address. It can be up to 64 characters long.
+        :param friendly_name: A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
         :param customer_name: The name to associate with the address.
         :param street: The number and street address of the address.
         :param city: The city of the address.
@@ -187,7 +187,7 @@ async def update_async(
         """
         Asynchronous coroutine to update the AddressInstance
 
-        :param friendly_name: A descriptive string that you create to describe the address. It can be up to 64 characters long.
+        :param friendly_name: A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
         :param customer_name: The name to associate with the address.
         :param street: The number and street address of the address.
         :param city: The city of the address.
@@ -336,7 +336,7 @@ def update(
         """
         Update the AddressInstance
 
-        :param friendly_name: A descriptive string that you create to describe the address. It can be up to 64 characters long.
+        :param friendly_name: A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
         :param customer_name: The name to associate with the address.
         :param street: The number and street address of the address.
         :param city: The city of the address.
@@ -394,7 +394,7 @@ async def update_async(
         """
         Asynchronous coroutine to update the AddressInstance
 
-        :param friendly_name: A descriptive string that you create to describe the address. It can be up to 64 characters long.
+        :param friendly_name: A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
         :param customer_name: The name to associate with the address.
         :param street: The number and street address of the address.
         :param city: The city of the address.
@@ -619,6 +619,7 @@ def stream(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         limit: Optional[int] = None,
         page_size: Optional[int] = None,
@@ -631,6 +632,7 @@ def stream(
 
         :param str customer_name: The `customer_name` of the Address resources to read.
         :param str friendly_name: The string that identifies the Address resources to read.
+        :param bool emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param str iso_country: The ISO country code of the Address resources to read.
         :param limit: Upper limit for the number of records to return. stream()
                       guarantees to never return more than limit.  Default is no limit
@@ -645,6 +647,7 @@ def stream(
         page = self.page(
             customer_name=customer_name,
             friendly_name=friendly_name,
+            emergency_enabled=emergency_enabled,
             iso_country=iso_country,
             page_size=limits["page_size"],
         )
@@ -655,6 +658,7 @@ async def stream_async(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         limit: Optional[int] = None,
         page_size: Optional[int] = None,
@@ -667,6 +671,7 @@ async def stream_async(
 
         :param str customer_name: The `customer_name` of the Address resources to read.
         :param str friendly_name: The string that identifies the Address resources to read.
+        :param bool emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param str iso_country: The ISO country code of the Address resources to read.
         :param limit: Upper limit for the number of records to return. stream()
                       guarantees to never return more than limit.  Default is no limit
@@ -681,6 +686,7 @@ async def stream_async(
         page = await self.page_async(
             customer_name=customer_name,
             friendly_name=friendly_name,
+            emergency_enabled=emergency_enabled,
             iso_country=iso_country,
             page_size=limits["page_size"],
         )
@@ -691,6 +697,7 @@ def list(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         limit: Optional[int] = None,
         page_size: Optional[int] = None,
@@ -702,6 +709,7 @@ def list(
 
         :param str customer_name: The `customer_name` of the Address resources to read.
         :param str friendly_name: The string that identifies the Address resources to read.
+        :param bool emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param str iso_country: The ISO country code of the Address resources to read.
         :param limit: Upper limit for the number of records to return. list() guarantees
                       never to return more than limit.  Default is no limit
@@ -716,6 +724,7 @@ def list(
             self.stream(
                 customer_name=customer_name,
                 friendly_name=friendly_name,
+                emergency_enabled=emergency_enabled,
                 iso_country=iso_country,
                 limit=limit,
                 page_size=page_size,
@@ -726,6 +735,7 @@ async def list_async(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         limit: Optional[int] = None,
         page_size: Optional[int] = None,
@@ -737,6 +747,7 @@ async def list_async(
 
         :param str customer_name: The `customer_name` of the Address resources to read.
         :param str friendly_name: The string that identifies the Address resources to read.
+        :param bool emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param str iso_country: The ISO country code of the Address resources to read.
         :param limit: Upper limit for the number of records to return. list() guarantees
                       never to return more than limit.  Default is no limit
@@ -752,6 +763,7 @@ async def list_async(
             async for record in await self.stream_async(
                 customer_name=customer_name,
                 friendly_name=friendly_name,
+                emergency_enabled=emergency_enabled,
                 iso_country=iso_country,
                 limit=limit,
                 page_size=page_size,
@@ -762,6 +774,7 @@ def page(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         page_token: Union[str, object] = values.unset,
         page_number: Union[int, object] = values.unset,
@@ -773,6 +786,7 @@ def page(
 
         :param customer_name: The `customer_name` of the Address resources to read.
         :param friendly_name: The string that identifies the Address resources to read.
+        :param emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param iso_country: The ISO country code of the Address resources to read.
         :param page_token: PageToken provided by the API
         :param page_number: Page Number, this value is simply for client state
@@ -784,6 +798,7 @@ def page(
             {
                 "CustomerName": customer_name,
                 "FriendlyName": friendly_name,
+                "EmergencyEnabled": serialize.boolean_to_string(emergency_enabled),
                 "IsoCountry": iso_country,
                 "PageToken": page_token,
                 "Page": page_number,
@@ -804,6 +819,7 @@ async def page_async(
         self,
         customer_name: Union[str, object] = values.unset,
         friendly_name: Union[str, object] = values.unset,
+        emergency_enabled: Union[bool, object] = values.unset,
         iso_country: Union[str, object] = values.unset,
         page_token: Union[str, object] = values.unset,
         page_number: Union[int, object] = values.unset,
@@ -815,6 +831,7 @@ async def page_async(
 
         :param customer_name: The `customer_name` of the Address resources to read.
         :param friendly_name: The string that identifies the Address resources to read.
+        :param emergency_enabled: Whether the address can be associated to a number for emergency calling.
         :param iso_country: The ISO country code of the Address resources to read.
         :param page_token: PageToken provided by the API
         :param page_number: Page Number, this value is simply for client state
@@ -826,6 +843,7 @@ async def page_async(
             {
                 "CustomerName": customer_name,
                 "FriendlyName": friendly_name,
+                "EmergencyEnabled": serialize.boolean_to_string(emergency_enabled),
                 "IsoCountry": iso_country,
                 "PageToken": page_token,
                 "Page": page_number,

twilio/rest/api/v2010/account/call/transcription.py

@@ -287,7 +287,7 @@ def create(
         :param speech_model: Recognition model used by the transcription engine, among those supported by the provider
         :param hints: A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
         :param enable_automatic_punctuation: The provider will add punctuation to recognition result
-        :param intelligence_service: The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+        :param intelligence_service: The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
 
         :returns: The created TranscriptionInstance
         """
@@ -362,7 +362,7 @@ async def create_async(
         :param speech_model: Recognition model used by the transcription engine, among those supported by the provider
         :param hints: A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
         :param enable_automatic_punctuation: The provider will add punctuation to recognition result
-        :param intelligence_service: The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+        :param intelligence_service: The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
 
         :returns: The created TranscriptionInstance
         """

twilio/rest/assistants/__init__.py

@@ -1,6 +1,6 @@
 from warnings import warn
 
-from twilio.rest.assistants import AssistantsBase
+from twilio.rest.assistants.AssistantsBase import AssistantsBase
 from twilio.rest.assistants.v1.assistant import AssistantList
 from twilio.rest.assistants.v1.knowledge import KnowledgeList
 from twilio.rest.assistants.v1.policy import PolicyList