Merge branch 'main' into main

Author: tiwarishubham635

.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,45 @@ twilio-python Changelog
 
 Here you can see the full list of changes between each twilio-python release.
 
+[2025-04-07] Version 9.5.2
+--------------------------
+**Studio**
+- Add documentation for parent_step_sid field in Step resource
+
+
+[2025-03-20] Version 9.5.1
+--------------------------
+**Accounts**
+- Update Safelist API docs as part of prefix supoort
+
+**Flex**
+- Removing `first_name`, `last_name`, and `friendly_name` from the Flex User API
+
+**Messaging**
+- Add missing tests under transaction/phone_numbers and transaction/short_code
+
+
+[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**

README.md

@@ -193,6 +193,8 @@ The library automatically handles paging for you. Collections, such as `calls` a
 
 `list` eagerly fetches all records and returns them as a list, whereas `stream` returns an iterator and lazily retrieves pages of records as you iterate over the collection. You can also page manually using the `page` method.
 
+`page_size` as a parameter is used to tell how many records should we get in every page and `limit` parameter is used to limit the max number of records we want to fetch.
+
 #### Use the `list` method
 
 ```python
@@ -206,6 +208,21 @@ for sms in client.messages.list():
   print(sms.to)
 ```
 
+```python
+client.messages.list(limit=20, page_size=20)
+```
+This will make 1 call that will fetch 20 records from backend service.
+
+```python
+client.messages.list(limit=20, page_size=10)
+```
+This will make 2 calls that will fetch 10 records each from backend service.
+
+```python
+client.messages.list(limit=20, page_size=100)
+```
+This  will make 1 call which will fetch 100 records but user will get only 20 records.
+
 ### Asynchronous API Requests
 
 By default, the Twilio Client will make synchronous requests to the Twilio API. To allow for asynchronous, non-blocking requests, we've included an optional asynchronous HTTP client. When used with the Client and the accompanying `*_async` methods, requests made to the Twilio API will be performed asynchronously.

setup.py

@@ -13,7 +13,7 @@
 
 setup(
     name="twilio",
-    version="9.4.6",
+    version="9.5.2",
     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)

twilio/__init__.py

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

twilio/rest/__init__.py

@@ -29,6 +29,7 @@
     from twilio.rest.insights import Insights
     from twilio.rest.intelligence import Intelligence
     from twilio.rest.ip_messaging import IpMessaging
+    from twilio.rest.knowledge import Knowledge
     from twilio.rest.lookups import Lookups
     from twilio.rest.marketplace import Marketplace
     from twilio.rest.messaging import Messaging
@@ -142,6 +143,7 @@ def __init__(
         self._insights: Optional["Insights"] = None
         self._intelligence: Optional["Intelligence"] = None
         self._ip_messaging: Optional["IpMessaging"] = None
+        self._knowledge: Optional["Knowledge"] = None
         self._lookups: Optional["Lookups"] = None
         self._marketplace: Optional["Marketplace"] = None
         self._messaging: Optional["Messaging"] = None
@@ -361,6 +363,19 @@ def ip_messaging(self) -> "IpMessaging":
             self._ip_messaging = IpMessaging(self)
         return self._ip_messaging
 
+    @property
+    def knowledge(self) -> "Knowledge":
+        """
+        Access the Knowledge Twilio Domain
+
+        :returns: Knowledge Twilio Domain
+        """
+        if self._knowledge is None:
+            from twilio.rest.knowledge import Knowledge
+
+            self._knowledge = Knowledge(self)
+        return self._knowledge
+
     @property
     def lookups(self) -> "Lookups":
         """

twilio/rest/accounts/v1/safelist.py

@@ -23,7 +23,7 @@
 class SafelistInstance(InstanceResource):
     """
     :ivar sid: The unique string that we created to identify the SafeList resource.
-    :ivar phone_number: The phone number in SafeList.
+    :ivar phone_number: The phone number or phone number 1k prefix in SafeList.
     """
 
     def __init__(self, version: Version, payload: Dict[str, Any]):
@@ -59,7 +59,7 @@ def create(self, phone_number: str) -> SafelistInstance:
         """
         Create the SafelistInstance
 
-        :param phone_number: The phone number to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
 
         :returns: The created SafelistInstance
         """
@@ -85,7 +85,7 @@ async def create_async(self, phone_number: str) -> SafelistInstance:
         """
         Asynchronously create the SafelistInstance
 
-        :param phone_number: The phone number to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
 
         :returns: The created SafelistInstance
         """
@@ -111,7 +111,7 @@ def delete(self, phone_number: Union[str, object] = values.unset) -> bool:
         """
         Asynchronously delete the SafelistInstance
 
-        :param phone_number: The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
         :returns: True if delete succeeds, False otherwise
         """
         headers = values.of({"Content-Type": "application/x-www-form-urlencoded"})
@@ -131,7 +131,7 @@ async def delete_async(
         """
         Asynchronously delete the SafelistInstance
 
-        :param phone_number: The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
         :returns: True if delete succeeds, False otherwise
         """
         headers = values.of({"Content-Type": "application/x-www-form-urlencoded"})
@@ -151,7 +151,7 @@ def fetch(
         """
         Asynchronously fetch the SafelistInstance
 
-        :param phone_number: The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
         :returns: The fetched SafelistInstance
         """
         headers = values.of({"Content-Type": "application/x-www-form-urlencoded"})
@@ -176,7 +176,7 @@ async def fetch_async(
         """
         Asynchronously fetch the SafelistInstance
 
-        :param phone_number: The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+        :param phone_number: The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
         :returns: The fetched SafelistInstance
         """
         headers = values.of({"Content-Type": "application/x-www-form-urlencoded"})

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

@@ -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/conference/__init__.py

@@ -51,7 +51,7 @@ class UpdateStatus(object):
     :ivar date_updated: The date and time in UTC that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
     :ivar api_version: The API version used to create this conference.
     :ivar friendly_name: A string that you assigned to describe this conference room. Maximum length is 128 characters.
-    :ivar region: A string that represents the Twilio Region where the conference audio was mixed. May be `us1`, `ie1`,  `de1`, `sg1`, `br1`, `au1`, and `jp1`. Basic conference audio will always be mixed in `us1`. Global Conference audio will be mixed nearest to the majority of participants.
+    :ivar region: A string that represents the Twilio Region where the conference audio was mixed. May be `us1`, `us2`, `ie1`,  `de1`, `sg1`, `br1`, `au1`, and `jp1`. Basic conference audio will always be mixed in `us1`. Global Conference audio will be mixed nearest to the majority of participants.
     :ivar sid: The unique, Twilio-provided string used to identify this Conference resource.
     :ivar status: 
     :ivar uri: The URI of this resource, relative to `https://api.twilio.com`.