Merge branch 'main' into VAPI-3161-add-refer-verb

Author: stampercasey

bandwidth.yml

@@ -2436,6 +2436,7 @@ components:
         - media
     rbmCardContent:
       type: object
+      description: Must contain at least one of title, description, or media to be valid.
       properties:
         title:
           type: string
@@ -2478,7 +2479,6 @@ components:
           $ref: '#/components/schemas/multiChannelFullActions'
       required:
         - orientation
-        - thumbnailImageAlignment
         - cardContent
     standaloneCardOrientationEnum:
       type: string
@@ -2489,8 +2489,8 @@ components:
     thumbnailAlignmentEnum:
       type: string
       description: >-
-        The alignment of the thumbnail image in the card. Only applicable if the
-        card using horizontal orientation.
+        The alignment of the thumbnail image in the card. Required when
+        orientation is HORIZONTAL.
       enum:
         - LEFT
         - RIGHT
@@ -2505,6 +2505,7 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/rbmCardContent'
+          minItems: 2
           maxItems: 10
         suggestions:
           $ref: '#/components/schemas/multiChannelFullActions'
@@ -2568,7 +2569,11 @@ components:
       type: string
       description: >-
         Defines the layout of the WebView on a mobile device. It must be defined
-        when application is set to `WEBVIEW`
+
+        when application is set to `WEBVIEW` and must not be set when
+        application
+
+        is set to `BROWSER`.
 
         - `FULL` WebView takes the full screen.
 
@@ -2626,12 +2631,16 @@ components:
             latitude:
               type: string
               format: double
-              description: The latitude of the location.
+              description: >-
+                The latitude of the location. Must be in range [-90.000000,
+                90.000000].
               example: '37.7749'
             longitude:
               type: string
               format: double
-              description: The longitude of the location.
+              description: >-
+                The longitude of the location. Must be in range [-180.000000,
+                180.000000].
               example: '-122.4194'
             label:
               type: string
@@ -2655,12 +2664,16 @@ components:
             startTime:
               type: string
               format: date-time
-              description: The start time of the event.
+              description: >-
+                The start time of the event. Must be a valid RFC-3339 value,
+                e.g., 2021-03-14T01:59:26Z or 2021-03-13T20:59:26-05:00.
               example: 2022-09-14T18:20:16.000Z
             endTime:
               type: string
               format: date-time
-              description: The end time of the event.
+              description: >-
+                The end time of the event. Must be a valid RFC-3339 value, e.g.,
+                2021-03-14T01:59:26Z or 2021-03-13T20:59:26-05:00.
               example: 2022-09-14T18:20:16.000Z
             description:
               type: string
@@ -2680,7 +2693,7 @@ components:
             url:
               type: string
               format: uri
-              description: The URL to open in browser.
+              description: The URL to open in browser. Must use http:// or https:// scheme.
               example: https://dev.bandwidth.com
               maxLength: 2048
             application:
@@ -5759,6 +5772,19 @@ components:
           items:
             type: string
             pattern: ^\+[1-9]\d{1,14}$
+        rcsAgent:
+          type: string
+          description: >-
+            Override the default RCS sender/agent ID used when checking RCS
+            capabilities.
+
+            When provided, this value is used as the `sender` in the RCS
+            capability-check request instead of the account default.
+
+            Must be 1–40 characters and contain only letters, digits,
+            underscores, or hyphens.
+          pattern: ^[A-Za-z0-9_-]{1,40}$
+          example: MyCustomRcsAgent
       required:
         - phoneNumbers
     asyncLookupRequest:
@@ -6008,12 +6034,30 @@ components:
       description: Reason code for denial.
       type: integer
       example: 511
+    denialStatusCodeNullable:
+      description: Reason code for denial.
+      nullable: true
+      type: integer
+      example: 511
     resubmitAllowed:
       description: >-
         Whether a Toll-Free Verification request qualifies for resubmission via
         PUT.
       example: true
       type: boolean
+    additionalDenialReason:
+      type: object
+      properties:
+        statusCode:
+          $ref: '#/components/schemas/denialStatusCode'
+        reason:
+          $ref: '#/components/schemas/declineReasonDescription'
+        resubmitAllowed:
+          $ref: '#/components/schemas/resubmitAllowed'
+      required:
+        - statusCode
+        - reason
+        - resubmitAllowed
     blocked:
       description: >-
         Whether a Toll-Free Verification is blocked. This attribute will only be
@@ -6168,19 +6212,6 @@ components:
       type: boolean
       description: Indicates whether the content is age-gated.
       example: false
-    additionalDenialReason:
-      properties:
-        statusCode:
-          $ref: '#/components/schemas/denialStatusCode'
-        reason:
-          $ref: '#/components/schemas/declineReasonDescription'
-        resubmitAllowed:
-          $ref: '#/components/schemas/resubmitAllowed'
-      required:
-        - statusCode
-        - reason
-        - resubmitAllowed
-      type: object
     internalTicketNumber:
       type: string
       description: >-
@@ -6376,6 +6407,7 @@ components:
           description: >-
             An optional list of denial reasons in addition to
             declineReasonDescription when multiple reasons apply.
+          type: array
           items:
             $ref: '#/components/schemas/additionalDenialReason'
           example:
@@ -6385,7 +6417,6 @@ components:
             - statusCode: 513
               reason: Reason B
               resubmitAllowed: true
-          type: array
         declineReasonDescription:
           $ref: '#/components/schemas/declineReasonDescription'
         denialStatusCode:
@@ -6753,6 +6784,23 @@ components:
           $ref: '#/components/schemas/internalTicketNumber'
         declineReasonDescription:
           $ref: '#/components/schemas/declineReasonDescription'
+        denialStatusCode:
+          $ref: '#/components/schemas/denialStatusCodeNullable'
+        additionalDenialReasons:
+          description: >-
+            An optional list of denial reasons in addition to
+            declineReasonDescription when multiple reasons apply.
+          nullable: true
+          type: array
+          items:
+            $ref: '#/components/schemas/additionalDenialReason'
+          example:
+            - statusCode: 512
+              reason: Reason A
+              resubmitAllowed: true
+            - statusCode: 513
+              reason: Reason B
+              resubmitAllowed: true
         resubmitAllowed:
           $ref: '#/components/schemas/resubmitAllowed'
         createdDateTime:
@@ -8758,6 +8806,13 @@ components:
         phoneNumbers:
           - '+19196104423'
           - '+19196104424'
+    rcsAgentRequestExample:
+      summary: Number Lookup Request with Custom RCS Agent
+      value:
+        phoneNumbers:
+          - '+19196104423'
+          - '+19196104424'
+        rcsAgent: MyCustomRcsAgent
     lookupAcceptedExample:
       summary: Numbers Lookup Accepted
       value:
@@ -9518,6 +9573,8 @@ components:
               $ref: '#/components/examples/singleNumberRequestExample'
             multipleNumberRequestExample:
               $ref: '#/components/examples/multipleNumberRequestExample'
+            rcsAgentRequestExample:
+              $ref: '#/components/examples/rcsAgentRequestExample'
     createAsyncBulkLookupRequest:
       description: Asynchronous bulk phone number lookup request.
       required: true

bandwidth/models/multi_channel_action_calendar_event.py

@@ -34,8 +34,8 @@ class MultiChannelActionCalendarEvent(BaseModel):
     text: Annotated[str, Field(strict=True, max_length=25)] = Field(description="Displayed text for user to click")
     postback_data: Union[Annotated[bytes, Field(strict=True, max_length=2048)], Annotated[str, Field(strict=True, max_length=2048)]] = Field(description="Base64 payload the customer receives when the reply is clicked.", alias="postbackData")
     title: Annotated[str, Field(strict=True, max_length=100)] = Field(description="The title of the event.")
-    start_time: datetime = Field(description="The start time of the event.", alias="startTime")
-    end_time: datetime = Field(description="The end time of the event.", alias="endTime")
+    start_time: datetime = Field(description="The start time of the event. Must be a valid RFC-3339 value, e.g., 2021-03-14T01:59:26Z or 2021-03-13T20:59:26-05:00.", alias="startTime")
+    end_time: datetime = Field(description="The end time of the event. Must be a valid RFC-3339 value, e.g., 2021-03-14T01:59:26Z or 2021-03-13T20:59:26-05:00.", alias="endTime")
     description: Optional[Annotated[str, Field(strict=True, max_length=500)]] = Field(default=None, description="The description of the event.")
     additional_properties: Dict[str, Any] = {}
     __properties: ClassVar[List[str]] = ["type", "text", "postbackData", "title", "startTime", "endTime", "description"]

bandwidth/models/rbm_action_open_url.py

@@ -34,7 +34,7 @@ class RbmActionOpenUrl(BaseModel):
     type: RbmActionTypeEnum
     text: Annotated[str, Field(strict=True, max_length=25)] = Field(description="Displayed text for user to click")
     postback_data: Union[Annotated[bytes, Field(strict=True, max_length=2048)], Annotated[str, Field(strict=True, max_length=2048)]] = Field(description="Base64 payload the customer receives when the reply is clicked.", alias="postbackData")
-    url: Annotated[str, Field(strict=True, max_length=2048)] = Field(description="The URL to open in browser.")
+    url: Annotated[str, Field(strict=True, max_length=2048)] = Field(description="The URL to open in browser. Must use http:// or https:// scheme.")
     application: Optional[RbmOpenUrlEnum] = None
     webview_view_mode: Optional[RbmWebViewEnum] = Field(default=None, alias="webviewViewMode")
     additional_properties: Dict[str, Any] = {}

bandwidth/models/rbm_action_view_location.py

@@ -32,8 +32,8 @@ class RbmActionViewLocation(BaseModel):
     type: RbmActionTypeEnum
     text: Annotated[str, Field(strict=True, max_length=25)] = Field(description="Displayed text for user to click")
     postback_data: Union[Annotated[bytes, Field(strict=True, max_length=2048)], Annotated[str, Field(strict=True, max_length=2048)]] = Field(description="Base64 payload the customer receives when the reply is clicked.", alias="postbackData")
-    latitude: StrictStr = Field(description="The latitude of the location.")
-    longitude: StrictStr = Field(description="The longitude of the location.")
+    latitude: StrictStr = Field(description="The latitude of the location. Must be in range [-90.000000, 90.000000].")
+    longitude: StrictStr = Field(description="The longitude of the location. Must be in range [-180.000000, 180.000000].")
     label: Optional[Annotated[str, Field(strict=True, max_length=100)]] = Field(default=None, description="The label of the location.")
     additional_properties: Dict[str, Any] = {}
     __properties: ClassVar[List[str]] = ["type", "text", "postbackData", "latitude", "longitude", "label"]

bandwidth/models/rbm_card_content.py

@@ -28,7 +28,7 @@
 
 class RbmCardContent(BaseModel):
     """
-    RbmCardContent
+    Must contain at least one of title, description, or media to be valid.
     """ # noqa: E501
     title: Optional[Annotated[str, Field(strict=True, max_length=200)]] = Field(default=None, description="The title of the card. Must be 200 characters or less.")
     description: Optional[Annotated[str, Field(strict=True, max_length=2000)]] = Field(default=None, description="The description of the card. Must be 2000 characters or less.")

bandwidth/models/rbm_message_carousel_card.py

@@ -32,7 +32,7 @@ class RbmMessageCarouselCard(BaseModel):
     RbmMessageCarouselCard
     """ # noqa: E501
     card_width: CardWidthEnum = Field(alias="cardWidth")
-    card_contents: Annotated[List[RbmCardContent], Field(max_length=10)] = Field(alias="cardContents")
+    card_contents: Annotated[List[RbmCardContent], Field(min_length=2, max_length=10)] = Field(alias="cardContents")
     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]] = ["cardWidth", "cardContents", "suggestions"]

bandwidth/models/rbm_standalone_card.py

@@ -33,7 +33,7 @@ class RbmStandaloneCard(BaseModel):
     RbmStandaloneCard
     """ # noqa: E501
     orientation: StandaloneCardOrientationEnum
-    thumbnail_image_alignment: ThumbnailAlignmentEnum = Field(alias="thumbnailImageAlignment")
+    thumbnail_image_alignment: Optional[ThumbnailAlignmentEnum] = Field(default=None, alias="thumbnailImageAlignment")
     card_content: RbmCardContent = Field(alias="cardContent")
     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] = {}

bandwidth/models/rbm_web_view_enum.py

@@ -21,7 +21,7 @@
 
 class RbmWebViewEnum(str, Enum):
     """
-    Defines the layout of the WebView on a mobile device. It must be defined when application is set to `WEBVIEW` - `FULL` WebView takes the full screen. - `HALF` WebView takes half of the screen. - `TALL` WebView takes three-quarters of the screen.
+    Defines the layout of the WebView on a mobile device. It must be defined when application is set to `WEBVIEW` and must not be set when application is set to `BROWSER`. - `FULL` WebView takes the full screen. - `HALF` WebView takes half of the screen. - `TALL` WebView takes three-quarters of the screen.
     """
 
     """

bandwidth/models/sync_lookup_request.py

@@ -19,7 +19,7 @@
 import json
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
-from typing import Any, ClassVar, Dict, List
+from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
 from typing import Optional, Set
 from typing_extensions import Self
@@ -29,8 +29,19 @@ class SyncLookupRequest(BaseModel):
     SyncLookupRequest
     """ # noqa: E501
     phone_numbers: List[Annotated[str, Field(strict=True)]] = Field(description="Telephone numbers in E.164 format.", alias="phoneNumbers")
+    rcs_agent: Optional[Annotated[str, Field(strict=True)]] = Field(default=None, description="Override the default RCS sender/agent ID used when checking RCS capabilities. When provided, this value is used as the `sender` in the RCS capability-check request instead of the account default. Must be 1–40 characters and contain only letters, digits, underscores, or hyphens.", alias="rcsAgent")
     additional_properties: Dict[str, Any] = {}
-    __properties: ClassVar[List[str]] = ["phoneNumbers"]
+    __properties: ClassVar[List[str]] = ["phoneNumbers", "rcsAgent"]
+
+    @field_validator('rcs_agent')
+    def rcs_agent_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if value is None:
+            return value
+
+        if not re.match(r"^[A-Za-z0-9_-]{1,40}$", value):
+            raise ValueError(r"must validate the regular expression /^[A-Za-z0-9_-]{1,40}$/")
+        return value
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -90,7 +101,8 @@ def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
             return cls.model_validate(obj)
 
         _obj = cls.model_validate({
-            "phoneNumbers": obj.get("phoneNumbers")
+            "phoneNumbers": obj.get("phoneNumbers"),
+            "rcsAgent": obj.get("rcsAgent")
         })
         # store additional fields in additional_properties
         for _key in obj.keys():