Merge branch 'main' into brtc-python-sdk

Author: smoghe-bw

bandwidth.yml

@@ -164,7 +164,13 @@ paths:
   /users/{accountId}/messages:
     get:
       summary: List Messages
-      description: Returns a list of messages based on query parameters.
+      description: >
+        Returns a list of messages based on query parameters.
+
+
+        **Rate Limit:** This endpoint is rate limited to 3500 requests per 5
+        minutes per Source IP address. Exceeding the limit returns HTTP 429 with
+        a `Retry-After` header.
       operationId: listMessages
       tags:
         - Messages
@@ -208,10 +214,12 @@ paths:
           $ref: '#/components/responses/messagingForbiddenError'
         '404':
           $ref: '#/components/responses/messagingNotFoundError'
+        '405':
+          $ref: '#/components/responses/messagingMethodNotAllowedError'
         '415':
           $ref: '#/components/responses/messagingInvalidMediaTypeError'
         '429':
-          $ref: '#/components/responses/messagingTooManyRequestsError'
+          $ref: '#/components/responses/listMessagesTooManyRequestsError'
         '500':
           $ref: '#/components/responses/messagingInternalServerError'
     post:
@@ -2417,7 +2425,9 @@ components:
       type: object
       properties:
         media:
-          $ref: '#/components/schemas/rbmMessageContentFile'
+          type: array
+          items:
+            $ref: '#/components/schemas/rbmMessageContentFile'
         suggestions:
           $ref: '#/components/schemas/multiChannelFullActions'
       required:
@@ -6035,15 +6045,13 @@ components:
       type: object
     internalTicketNumber:
       type: string
-      format: uuid
       description: >-
         Unique identifier (UUID) generated by Bandwidth to assist in tracking
         the verification status of a toll-free number - included in all webhook
         payloads.
       example: acde070d-8c4c-4f0d-9d8a-162843c10333
     internalTicketNumberForWebhook:
       type: string
-      format: uuid
       description: >-
         Unique identifier (UUID) generated by Bandwidth to assist in tracking
         the verification status of a toll-free number.
@@ -7209,6 +7217,23 @@ components:
               - type: internal-server-error
                 description: Internal server error. No further information available
                 source: {}
+    listMessagesTooManyRequestsError:
+      description: Too Many Requests
+      headers:
+        Retry-After:
+          description: The number of seconds to wait before retrying the request.
+          schema:
+            type: integer
+            example: 300
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/messagingRequestError'
+          example:
+            type: rate_limit_exceeded
+            description: >-
+              Rate limit exceeded. Wait for Retry-After time before sending
+              another request.
     createCallResponse:
       description: Created
       headers:

bandwidth/api/messages_api.py

@@ -412,7 +412,7 @@ def list_messages(
     ) -> MessagesList:
         """List Messages
 
-        Returns a list of messages based on query parameters.
+        Returns a list of messages based on query parameters.  **Rate Limit:** This endpoint is rate limited to 3500 requests per 5 minutes per Source IP address. Exceeding the limit returns HTTP 429 with a `Retry-After` header. 
 
         :param account_id: Your Bandwidth Account ID. (required)
         :type account_id: str
@@ -533,6 +533,7 @@ def list_messages(
             '401': "MessagingRequestError",
             '403': "MessagingRequestError",
             '404': "MessagingRequestError",
+            '405': "MessagingRequestError",
             '415': "MessagingRequestError",
             '429': "MessagingRequestError",
             '500': "MessagingRequestError",
@@ -594,7 +595,7 @@ def list_messages_with_http_info(
     ) -> ApiResponse[MessagesList]:
         """List Messages
 
-        Returns a list of messages based on query parameters.
+        Returns a list of messages based on query parameters.  **Rate Limit:** This endpoint is rate limited to 3500 requests per 5 minutes per Source IP address. Exceeding the limit returns HTTP 429 with a `Retry-After` header. 
 
         :param account_id: Your Bandwidth Account ID. (required)
         :type account_id: str
@@ -715,6 +716,7 @@ def list_messages_with_http_info(
             '401': "MessagingRequestError",
             '403': "MessagingRequestError",
             '404': "MessagingRequestError",
+            '405': "MessagingRequestError",
             '415': "MessagingRequestError",
             '429': "MessagingRequestError",
             '500': "MessagingRequestError",
@@ -776,7 +778,7 @@ def list_messages_without_preload_content(
     ) -> RESTResponseType:
         """List Messages
 
-        Returns a list of messages based on query parameters.
+        Returns a list of messages based on query parameters.  **Rate Limit:** This endpoint is rate limited to 3500 requests per 5 minutes per Source IP address. Exceeding the limit returns HTTP 429 with a `Retry-After` header. 
 
         :param account_id: Your Bandwidth Account ID. (required)
         :type account_id: str
@@ -897,6 +899,7 @@ def list_messages_without_preload_content(
             '401': "MessagingRequestError",
             '403': "MessagingRequestError",
             '404': "MessagingRequestError",
+            '405': "MessagingRequestError",
             '415': "MessagingRequestError",
             '429': "MessagingRequestError",
             '500': "MessagingRequestError",

bandwidth/models/blocked_webhook.py

@@ -21,7 +21,6 @@
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr, field_validator
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
-from uuid import UUID
 from bandwidth.models.tfv_callback_status_enum import TfvCallbackStatusEnum
 from typing import Optional, Set
 from typing_extensions import Self
@@ -33,7 +32,7 @@ class BlockedWebhook(BaseModel):
     account_id: Optional[StrictStr] = Field(default=None, description="User's account ID.", alias="accountId")
     phone_number: Optional[Annotated[str, Field(min_length=12, strict=True, max_length=12)]] = Field(default=None, description="Toll-free telephone number in E.164 format.", alias="phoneNumber")
     status: Optional[TfvCallbackStatusEnum] = None
-    internal_ticket_number: Optional[UUID] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number.", alias="internalTicketNumber")
+    internal_ticket_number: Optional[StrictStr] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number.", alias="internalTicketNumber")
     blocked: Optional[StrictBool] = Field(default=None, description="Whether a Toll-Free Verification is blocked. This attribute will only be defined when the number is blocked.")
     blocked_reason: Optional[StrictStr] = Field(default=None, description="The reason why the Toll-Free Verification is blocked. This attribute will only be defined when the number is blocked.", alias="blockedReason")
     additional_properties: Dict[str, Any] = {}

bandwidth/models/callback.py

@@ -42,8 +42,18 @@ class Callback(BaseModel):
         protected_namespaces=(),
     )
 
-
-    discriminator_value_class_map: Dict[str, str] = {
+    # Discriminator's property name (OpenAPI v3)
+    __openapi_discriminator_name__ = 'type'
+
+    # Discriminator's mapping (OpenAPI v3)
+    __discriminator_value_class_map__ = {
+        'message-delivered': 'StatusCallback',
+        'message-failed': 'StatusCallback',
+        'message-read': 'StatusCallback',
+        'message-received': 'InboundCallback',
+        'message-sent': 'StatusCallback',
+        'request-location-response': 'InboundCallback',
+        'suggestion-response': 'InboundCallback'
     }
 
     def __init__(self, *args, **kwargs) -> None:
@@ -88,6 +98,20 @@ def from_dict(cls, obj: Union[str, Dict[str, Any]]) -> Self:
     def from_json(cls, json_str: str) -> Self:
         """Returns the object represented by the json string"""
         instance = cls.model_construct()
+
+        # Try to deserialize using the discriminator
+        json_obj = json.loads(json_str)
+        discriminator_value = json_obj.get(cls.__openapi_discriminator_name__)
+        
+        if discriminator_value and discriminator_value in cls.__discriminator_value_class_map__:
+            class_name = cls.__discriminator_value_class_map__[discriminator_value]
+            target_class = globals()[class_name]
+            try:
+                instance.actual_instance = target_class.from_json(json_str)
+                return instance
+            except (ValidationError, ValueError) as e:
+                raise ValueError(f"Failed to deserialize using discriminator '{discriminator_value}' -> {class_name}: {str(e)}")
+
         error_messages = []
         match = 0
 

bandwidth/models/failure_webhook.py

@@ -21,7 +21,6 @@
 from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
-from uuid import UUID
 from typing import Optional, Set
 from typing_extensions import Self
 
@@ -34,7 +33,7 @@ class FailureWebhook(BaseModel):
     error_code: Optional[StrictStr] = Field(default=None, description="An error code indicating what error was encountered. This code can be interpreted as an HTTP status code in regards to the error that was encountered.", alias="errorCode")
     error_message: Optional[StrictStr] = Field(default=None, description="A description of the error that was encountered.", alias="errorMessage")
     errors: Optional[List[StrictStr]] = Field(default=None, description="Details of the errors that were encountered when processing the request.")
-    internal_ticket_number: Optional[UUID] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number.", alias="internalTicketNumber")
+    internal_ticket_number: Optional[StrictStr] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number.", alias="internalTicketNumber")
     additional_properties: Dict[str, Any] = {}
     __properties: ClassVar[List[str]] = ["accountId", "phoneNumber", "errorCode", "errorMessage", "errors", "internalTicketNumber"]
 

bandwidth/models/multi_channel_action.py

@@ -57,7 +57,17 @@ class MultiChannelAction(BaseModel):
         "protected_namespaces": (),
     }
 
-    discriminator_value_class_map: Dict[str, str] = {
+    # Discriminator's property name (OpenAPI v3)
+    __openapi_discriminator_name__ = 'type'
+
+    # Discriminator's mapping (OpenAPI v3)
+    __discriminator_value_class_map__ = {
+        'CREATE_CALENDAR_EVENT': 'MultiChannelActionCalendarEvent',
+        'DIAL_PHONE': 'RbmActionDial',
+        'OPEN_URL': 'RbmActionOpenUrl',
+        'REPLY': 'RbmActionBase',
+        'REQUEST_LOCATION': 'RbmActionBase',
+        'SHOW_LOCATION': 'RbmActionViewLocation'
     }
 
     def __init__(self, *args, **kwargs) -> None:
@@ -118,6 +128,20 @@ def from_dict(cls, obj: Dict[str, Any]) -> Self:
     def from_json(cls, json_str: str) -> Self:
         """Returns the object represented by the json string"""
         instance = cls.model_construct()
+
+        # Try to deserialize using the discriminator
+        json_obj = json.loads(json_str)
+        discriminator_value = json_obj.get(cls.__openapi_discriminator_name__)
+        
+        if discriminator_value and discriminator_value in cls.__discriminator_value_class_map__:
+            class_name = cls.__discriminator_value_class_map__[discriminator_value]
+            target_class = globals()[class_name]
+            try:
+                instance.actual_instance = target_class.from_json(json_str)
+                return instance
+            except (ValidationError, ValueError) as e:
+                raise ValueError(f"Failed to deserialize using discriminator '{discriminator_value}' -> {class_name}: {str(e)}")
+
         error_messages = []
         # anyof_schema_1_validator: Optional[RbmActionBase] = None
         try:

bandwidth/models/multi_channel_channel_list_request_object.py

@@ -51,7 +51,14 @@ class MultiChannelChannelListRequestObject(BaseModel):
         "protected_namespaces": (),
     }
 
-    discriminator_value_class_map: Dict[str, str] = {
+    # Discriminator's property name (OpenAPI v3)
+    __openapi_discriminator_name__ = 'channel'
+
+    # Discriminator's mapping (OpenAPI v3)
+    __discriminator_value_class_map__ = {
+        'MMS': 'MultiChannelChannelListMMSObject',
+        'RBM': 'MultiChannelChannelListRBMObject',
+        'SMS': 'MultiChannelChannelListSMSObject'
     }
 
     def __init__(self, *args, **kwargs) -> None:
@@ -100,6 +107,20 @@ def from_dict(cls, obj: Dict[str, Any]) -> Self:
     def from_json(cls, json_str: str) -> Self:
         """Returns the object represented by the json string"""
         instance = cls.model_construct()
+
+        # Try to deserialize using the discriminator
+        json_obj = json.loads(json_str)
+        discriminator_value = json_obj.get(cls.__openapi_discriminator_name__)
+        
+        if discriminator_value and discriminator_value in cls.__discriminator_value_class_map__:
+            class_name = cls.__discriminator_value_class_map__[discriminator_value]
+            target_class = globals()[class_name]
+            try:
+                instance.actual_instance = target_class.from_json(json_str)
+                return instance
+            except (ValidationError, ValueError) as e:
+                raise ValueError(f"Failed to deserialize using discriminator '{discriminator_value}' -> {class_name}: {str(e)}")
+
         error_messages = []
         # anyof_schema_1_validator: Optional[MultiChannelChannelListRBMObject] = None
         try:

bandwidth/models/multi_channel_channel_list_response_object.py

@@ -51,7 +51,14 @@ class MultiChannelChannelListResponseObject(BaseModel):
         "protected_namespaces": (),
     }
 
-    discriminator_value_class_map: Dict[str, str] = {
+    # Discriminator's property name (OpenAPI v3)
+    __openapi_discriminator_name__ = 'channel'
+
+    # Discriminator's mapping (OpenAPI v3)
+    __discriminator_value_class_map__ = {
+        'MMS': 'MultiChannelChannelListMMSResponseObject',
+        'RBM': 'MultiChannelChannelListRBMResponseObject',
+        'SMS': 'MultiChannelChannelListSMSResponseObject'
     }
 
     def __init__(self, *args, **kwargs) -> None:
@@ -100,6 +107,20 @@ def from_dict(cls, obj: Dict[str, Any]) -> Self:
     def from_json(cls, json_str: str) -> Self:
         """Returns the object represented by the json string"""
         instance = cls.model_construct()
+
+        # Try to deserialize using the discriminator
+        json_obj = json.loads(json_str)
+        discriminator_value = json_obj.get(cls.__openapi_discriminator_name__)
+        
+        if discriminator_value and discriminator_value in cls.__discriminator_value_class_map__:
+            class_name = cls.__discriminator_value_class_map__[discriminator_value]
+            target_class = globals()[class_name]
+            try:
+                instance.actual_instance = target_class.from_json(json_str)
+                return instance
+            except (ValidationError, ValueError) as e:
+                raise ValueError(f"Failed to deserialize using discriminator '{discriminator_value}' -> {class_name}: {str(e)}")
+
         error_messages = []
         # anyof_schema_1_validator: Optional[MultiChannelChannelListRBMResponseObject] = None
         try:

bandwidth/models/rbm_message_media.py

@@ -30,7 +30,7 @@ class RbmMessageMedia(BaseModel):
     """
     RbmMessageMedia
     """ # noqa: E501
-    media: RbmMessageContentFile
+    media: List[RbmMessageContentFile]
     suggestions: Optional[Annotated[List[MultiChannelAction], Field(max_length=11)]] = Field(default=None, description="An array of suggested actions for the recipient.")
     additional_properties: Dict[str, Any] = {}
     __properties: ClassVar[List[str]] = ["media", "suggestions"]
@@ -76,9 +76,13 @@ def to_dict(self) -> Dict[str, Any]:
             exclude=excluded_fields,
             exclude_none=True,
         )
-        # override the default output from pydantic by calling `to_dict()` of media
+        # override the default output from pydantic by calling `to_dict()` of each item in media (list)
+        _items = []
         if self.media:
-            _dict['media'] = self.media.to_dict()
+            for _item_media in self.media:
+                if _item_media:
+                    _items.append(_item_media.to_dict())
+            _dict['media'] = _items
         # override the default output from pydantic by calling `to_dict()` of each item in suggestions (list)
         _items = []
         if self.suggestions:
@@ -103,7 +107,7 @@ def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
             return cls.model_validate(obj)
 
         _obj = cls.model_validate({
-            "media": RbmMessageContentFile.from_dict(obj["media"]) if obj.get("media") is not None else None,
+            "media": [RbmMessageContentFile.from_dict(_item) for _item in obj["media"]] if obj.get("media") is not None else None,
             "suggestions": [MultiChannelAction.from_dict(_item) for _item in obj["suggestions"]] if obj.get("suggestions") is not None else None
         })
         # store additional fields in additional_properties

bandwidth/models/tfv_status.py

@@ -22,7 +22,6 @@
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr, field_validator
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
-from uuid import UUID
 from bandwidth.models.tfv_status_enum import TfvStatusEnum
 from bandwidth.models.tfv_submission_info import TfvSubmissionInfo
 from typing import Optional, Set
@@ -34,7 +33,7 @@ class TfvStatus(BaseModel):
     """ # noqa: E501
     phone_number: Optional[Annotated[str, Field(min_length=12, strict=True, max_length=12)]] = Field(default=None, description="Toll-free telephone number in E.164 format.", alias="phoneNumber")
     status: Optional[TfvStatusEnum] = None
-    internal_ticket_number: Optional[UUID] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number - included in all webhook payloads.", alias="internalTicketNumber")
+    internal_ticket_number: Optional[StrictStr] = Field(default=None, description="Unique identifier (UUID) generated by Bandwidth to assist in tracking the verification status of a toll-free number - included in all webhook payloads.", alias="internalTicketNumber")
     decline_reason_description: Optional[StrictStr] = Field(default=None, description="Explanation for why a verification request was declined.", alias="declineReasonDescription")
     resubmit_allowed: Optional[StrictBool] = Field(default=None, description="Whether a Toll-Free Verification request qualifies for resubmission via PUT.", alias="resubmitAllowed")
     created_date_time: Optional[datetime] = Field(default=None, description="Date and time the verification request was created.", alias="createdDateTime")