twilio-ruby 5.10.7 → 5.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: da9f21f9decc5e739bf2e9d6e459f86e2d4e4ead
-  data.tar.gz: 3e167ee387f6cb92a862f752bc90b00570e16935
+  metadata.gz: 1b2e383ba3a1cdb7ac1935ff265cf2c2c7f984da
+  data.tar.gz: ab1586c39a2a53cd964a89f8401d31056522070d
 SHA512:
-  metadata.gz: 65f05038a1226db7b0ed1b950242ed8e4e7d6614cbc258ce840c7866a721471f6fc4c4b589d1097f266a9895ba18f6c929d61fc683923148ebebdd21a6b7e2b2
-  data.tar.gz: f3ab0edfa7891346ef7cebf162f05c19dd9d11d64172aa272ea8f1bc73ccba5192eb14db835be9dfa246fedb040f983635bb95dd8ab91c279754f699c56424e2
+  metadata.gz: d0924160a623cb392ffc3ed6d6b863afcced646cb19beccec461d1d9e16bf3f77f1c08a522b09edee4524cc0db12a3d4c826be22d9179bf8cf3ad5070e0a570c
+  data.tar.gz: 00f50a63129f3b0ef5e92c98f95890bcc48fc753041b8997c6a2899fd4e022caa57552c0fa6566940bee0fbb9779e0af85014ae9bf493eea8c1d3faae96cdc3f

data/.travis.yml

@@ -5,11 +5,10 @@ bundler_args: --without development
 
 rvm:
   - ruby-head
+  - 2.5.0
   - 2.4.0
   - 2.3.0
   - 2.2.0
-  - 2.1
-  - 2.0.0
   - jruby-9.1.9.0
 
 services:

data/CHANGES.md

@@ -1,6 +1,17 @@
 twilio-ruby changelog
 =====================
 
+[2018-07-16] Version 5.11.0
+----------------------------
+**Library**
+- PR #421: Fix TwiML Say verb spec. Thanks to @HuipengRen!
+- PR #419: Add a request body validator. Thanks to @cjcodes!
+- PR #418: Remove support for ruby 2.0 and 2.1, adds 2.5. Thanks to @cjcodes!
+
+**Twiml**
+- Add support for SSML on Say verb, the message body is changed to be optional **(breaking change)**
+
+
 [2018-07-11] Version 5.10.7
 ----------------------------
 **Api**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.10.7'
+gem 'twilio-ruby', '~> 5.11.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.10.7
+gem install twilio-ruby -v 5.11.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -178,11 +178,10 @@ This will print the following (except for the whitespace):
 This library supports and is [tested against][travis] the following Ruby
 implementations:
 
+- Ruby 2.5.0
 - Ruby 2.4.0
 - Ruby 2.3.0
 - Ruby 2.2.0
-- Ruby 2.1.0
-- Ruby 2.0.0
 
 [capability]: https://github.com/twilio/twilio-ruby/wiki/JWT-Tokens
 [examples]: https://github.com/twilio/twilio-ruby/blob/master/examples

data/lib/twilio-ruby/rest/api/v2010/account/call/recording.rb

@@ -42,18 +42,14 @@ module Twilio
               #   `trim-silence` will trim the silence from the beginning and end of the
               #   recording. `do-not-trim` will not trim the silence. Defaults to `do-not-trim`
               # @param [String] recording_channels The recording_channels
-              # @param [Boolean] play_beep Possible values : true or false.  true will play a
-              #   double beep before the recording is paused or stopped or a single beep after the
-              #   recording is resumed. Defaults to false
               # @return [RecordingInstance] Newly created RecordingInstance
-              def create(recording_status_callback_event: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, trim: :unset, recording_channels: :unset, play_beep: :unset)
+              def create(recording_status_callback_event: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, trim: :unset, recording_channels: :unset)
                 data = Twilio::Values.of({
                     'RecordingStatusCallbackEvent' => Twilio.serialize_list(recording_status_callback_event) { |e| e },
                     'RecordingStatusCallback' => recording_status_callback,
                     'RecordingStatusCallbackMethod' => recording_status_callback_method,
                     'Trim' => trim,
                     'RecordingChannels' => recording_channels,
-                    'PlayBeep' => play_beep,
                 })
 
                 payload = @version.create(

data/lib/twilio-ruby/rest/api/v2010/account/message.rb

@@ -30,33 +30,37 @@ module Twilio
             # Retrieve a single page of MessageInstance records from the API.
             # Request is executed immediately.
             # @param [String] to The destination phone number for SMS/MMS or a [Channel user
-            #   address](https://www.twilio.com/docs/api/channels#channel-addresses) for other
+            #   address](https://www.twilio.com/docs/sms/channels#channel-addresses) for other
             #   3rd party channels. Destination phone numbers should be formatted with a '+' and
             #   country code e.g., +16175551212
             #   ([E.164](https://www.twilio.com/docs/glossary/what-e164) format).
             # @param [String] status_callback A URL where Twilio will POST each time your
             #   message status changes to one of the following: `queued`, `failed`, `sent`,
-            #   `delivered`, or `undelivered`. Twilio will POST the `MessageSid` along with the
-            #   other [standard request
-            #   parameters](https://www.twilio.com/docs/api/twiml/sms/twilio_request#request-parameters) as well as `MessageStatus` and `ErrorCode`. If this parameter passed in addition to a `MessagingServiceSid`, Twilio will override the Status Callback URL of the [Messaging Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services). URLs must contain a valid hostname (underscores are not allowed).
+            #   `delivered`, or `undelivered`. Twilio will POST the `MessageSid`,
+            #   `MessageStatus`, and `ErrorCode` along with the other [standard request
+            #   parameters](https://www.twilio.com/docs/sms/twiml#request-parameters). If you
+            #   include this parameter in addition to a `MessagingServiceSid`, Twilio will
+            #   override the Status Callback URL of the [Messaging
+            #   Service](https://www.twilio.com/docs/sms/services/api). URLs must contain a
+            #   valid hostname – underscores are not allowed.
             # @param [String] application_sid Twilio will POST `MessageSid` as well as
             #   `MessageStatus=sent` or `MessageStatus=failed` to the URL in the
             #   `MessageStatusCallback` property of this
-            #   [Application](https://www.twilio.com/docs/api/rest/applications). If the
-            #   `StatusCallback` parameter above is also passed, the Application's
+            #   [application](https://www.twilio.com/docs/usage/api/applications). If the
+            #   `StatusCallback` parameter is also passed, the application's
             #   `MessageStatusCallback` parameter will take precedence.
             # @param [String] max_price The total maximum price up to the fourth decimal
-            #   (0.0001) in US dollars acceptable for the message to be delivered. All messages
-            #   regardless of the price point will be queued for delivery. A POST request will
+            #   (0.0001) in US dollars acceptable for the message to be delivered. *All messages
+            #   will be queued for delivery regardless of the price point.* A POST request will
             #   later be made to your Status Callback URL with a status change of 'Sent' or
-            #   'Failed'. When the price of the message is above this value the message will
-            #   fail and not be sent. When MaxPrice is not set, all prices for the message is
-            #   accepted.
+            #   'Failed'. When the price of the message is greater than this value, the message
+            #   will fail and not be sent. When `MaxPrice` is not set, all prices for the
+            #   message are accepted.
             # @param [Boolean] provide_feedback Set this value to `true` if you are sending
             #   messages that have a trackable user action and you intend to confirm delivery of
             #   the message using the [Message Feedback
-            #   API](https://www.twilio.com/docs/api/messaging/message-feedback). This parameter
-            #   is set to `false` by default.
+            #   API](https://www.twilio.com/docs/sms/api/message-feedback). This parameter is
+            #   `false` by default.
             # @param [String] validity_period The number of seconds that the message can
             #   remain in a Twilio queue. After exceeding this time limit, the message will fail
             #   and a POST request will later be made to your Status Callback URL. Valid values
@@ -71,26 +75,26 @@ module Twilio
             # @param [Boolean] smart_encoded The smart_encoded
             # @param [String] from A Twilio phone number (in
             #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format),  [alphanumeric
-            #   sender
-            #   ID](https://www.twilio.com/docs/api/messaging/send-messages#alpha-sender-id) or
-            #   a [Channel Endpoint
-            #   address](https://www.twilio.com/docs/api/channels#channel-addresses) enabled for
+            #   sender ID](https://www.twilio.com/docs/sms/send-messages#alphanumeric-sender-id)
+            #   or a [Channel Endpoint
+            #   address](https://www.twilio.com/docs/sms/channels#channel-addresses) enabled for
             #   the type of message you wish to send. Phone numbers or [short
             #   codes](https://www.twilio.com/docs/sms/api/short-codes) purchased from Twilio
             #   work here. You cannot (for example) spoof messages from your own cell phone
-            #   number. *Should not be passed if you are using MessagingServiceSid.*
-            # @param [String] messaging_service_sid The 34 character unique id of the
+            #   number. *Should not be passed if you are using `MessagingServiceSid`.*
+            # @param [String] messaging_service_sid The 34-character unique ID of the
             #   [Messaging
-            #   Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services) you want to associate with this Message. Set this parameter to use the Messaging Service Settings and [Copilot Features](https://www.twilio.com/docs/api/messaging/send-messages-copilot) you have configured. When only this parameter is set, Twilio will use your enabled Copilot Features to select the From phone number for delivery. *Should not be passed if you are using From.*
+            #   Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services) you want to associate with this Message. Set this parameter to use the Messaging Service Settings and [Copilot Features](https://www.twilio.com/docs/sms/services) you have configured. When only this parameter is set, Twilio will use your enabled Copilot Features to select the `From` phone number for delivery. *Should not be passed if you are using `From`.*
             # @param [String] body The text of the message you want to send, limited to 1600
             #   characters.
-            # @param [String] media_url The URL of the media you wish to send out with the
+            # @param [String] media_url The URL of the media you wish to send with the
             #   message. `gif` , `png` and `jpeg` content is currently supported and will be
             #   formatted correctly on the recipient's device. [Other
-            #   types](https://www.twilio.com/docs/api/messaging/accepted-mime-types) are also
-            #   accepted by the API. The media size limit is 5MB. If you wish to send more than
-            #   one image in the message body, please provide multiple MediaUrls values in the
-            #   POST request. You may include up to 10 MediaUrls per message.
+            #   types](https://www.twilio.com/docs/sms/accepted-mime-types) are also accepted by
+            #   the API. The media size limit is 5MB. If you wish to send more than one image in
+            #   the message body, please provide multiple `MediaUrl` values in the POST request.
+            #   You may include up to 10 MediaUrls per message. *Sending images via SMS is
+            #   currently only possible in the US and Canada*
             # @return [MessageInstance] Newly created MessageInstance
             def create(to: nil, status_callback: :unset, application_sid: :unset, max_price: :unset, provide_feedback: :unset, validity_period: :unset, max_rate: :unset, force_delivery: :unset, provider_sid: :unset, content_retention: :unset, address_retention: :unset, smart_encoded: :unset, from: :unset, messaging_service_sid: :unset, body: :unset, media_url: :unset)
               data = Twilio::Values.of({

data/lib/twilio-ruby/rest/api/v2010/account/usage/record.rb

@@ -51,7 +51,9 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
-              # @param [Boolean] include_subaccounts The include_subaccounts
+              # @param [Boolean] include_subaccounts `true` to include usage from the master
+              #   account and all subaccounts. `false` to only retrieve usage from the specified
+              #   account. `IncludeSubaccounts` is `true` by default.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -84,7 +86,9 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
-              # @param [Boolean] include_subaccounts The include_subaccounts
+              # @param [Boolean] include_subaccounts `true` to include usage from the master
+              #   account and all subaccounts. `false` to only retrieve usage from the specified
+              #   account. `IncludeSubaccounts` is `true` by default.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -133,7 +137,9 @@ module Twilio
               #   date.  Format is YYYY-MM-DD.  All dates are in GMT.  As a convenience, you can
               #   also specify offsets to today.  For example, `EndDate=+30days` will make
               #   `EndDate` be 30 days from today.
-              # @param [Boolean] include_subaccounts The include_subaccounts
+              # @param [Boolean] include_subaccounts `true` to include usage from the master
+              #   account and all subaccounts. `false` to only retrieve usage from the specified
+              #   account. `IncludeSubaccounts` is `true` by default.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
               # @param [Integer] page_size Number of records to return, defaults to 50

data/lib/twilio-ruby/rest/monitor/v1.rb

@@ -34,7 +34,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @param [String] sid A 34 character string that uniquely identifies this event.
         # @return [Twilio::REST::Monitor::V1::EventContext] if sid was passed.
         # @return [Twilio::REST::Monitor::V1::EventList]
         def events(sid=:unset)

data/lib/twilio-ruby/rest/monitor/v1/event.rb

@@ -27,12 +27,22 @@ module Twilio
           # Lists EventInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Time] start_date The start_date
-          # @param [Time] end_date The end_date
+          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include Events of this EventType.
+          # @param [String] resource_sid Only include Events referring to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include Events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only show events on or after this date. Useful in
+          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
+          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
+          #   ignored by the filter.
+          # @param [Time] end_date Only show events on or before this date. Useful in
+          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
+          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
+          #   is ignored by the filter.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit.  Default is no limit
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -57,12 +67,22 @@ module Twilio
           # Streams EventInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Time] start_date The start_date
-          # @param [Time] end_date The end_date
+          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include Events of this EventType.
+          # @param [String] resource_sid Only include Events referring to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include Events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only show events on or after this date. Useful in
+          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
+          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
+          #   ignored by the filter.
+          # @param [Time] end_date Only show events on or before this date. Useful in
+          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
+          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
+          #   is ignored by the filter.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit. Default is no limit.
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -103,12 +123,22 @@ module Twilio
           ##
           # Retrieve a single page of EventInstance records from the API.
           # Request is executed immediately.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Time] start_date The start_date
-          # @param [Time] end_date The end_date
+          # @param [String] actor_sid Only include Events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include Events of this EventType.
+          # @param [String] resource_sid Only include Events referring to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include Events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only show events on or after this date. Useful in
+          #   combination with `EndDate` to define a date-range of events. Input is a [UTC ISO
+          #   8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day is
+          #   ignored by the filter.
+          # @param [Time] end_date Only show events on or before this date. Useful in
+          #   combination with `StartDate` to define a date-range of events. Input is a [UTC
+          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
+          #   is ignored by the filter.
           # @param [String] page_token PageToken provided by the API
           # @param [Integer] page_number Page Number, this value is simply for client state
           # @param [Integer] page_size Number of records to return, defaults to 50
@@ -186,7 +216,7 @@ module Twilio
           ##
           # Initialize the EventContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid A 34 character string that uniquely identifies this event.
           # @return [EventContext] EventContext
           def initialize(version, sid)
             super(version)
@@ -224,7 +254,7 @@ module Twilio
           # Initialize the EventInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid A 34 character string that uniquely identifies this event.
           # @return [EventInstance] EventInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -264,19 +294,19 @@ module Twilio
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] A 34 character string identifying the Account for which this Event was recorded.
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The actor_sid
+          # @return [String] If available, a 34 character string identifying the actor that caused this event. May be null.
           def actor_sid
             @properties['actor_sid']
           end
 
           ##
-          # @return [String] The actor_type
+          # @return [String] The type of actor that caused this event
           def actor_type
             @properties['actor_type']
           end
@@ -288,31 +318,31 @@ module Twilio
           end
 
           ##
-          # @return [Hash] The event_data
+          # @return [Hash] A freeform json object encoding additional data about the event
           def event_data
             @properties['event_data']
           end
 
           ##
-          # @return [Time] The event_date
+          # @return [Time] The date-time the event was recorded
           def event_date
             @properties['event_date']
           end
 
           ##
-          # @return [String] The event_type
+          # @return [String] The event's type, as a string.
           def event_type
             @properties['event_type']
           end
 
           ##
-          # @return [String] The resource_sid
+          # @return [String] A 34 character string identifying the resource that was affected.
           def resource_sid
             @properties['resource_sid']
           end
 
           ##
-          # @return [String] The resource_type
+          # @return [String] The type of resource that was affected
           def resource_type
             @properties['resource_type']
           end
@@ -330,7 +360,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The source_ip_address
+          # @return [String] The IP address of the source
           def source_ip_address
             @properties['source_ip_address']
           end

data/lib/twilio-ruby/rest/preview.rb

@@ -134,14 +134,6 @@ module Twilio
         self.hosted_numbers.hosted_number_orders(sid)
       end
 
-      ##
-      # @param [String] sid A 34 character string that uniquely identifies this Add-on.
-      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnInstance] if sid was passed.
-      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
-      def available_add_ons(sid=:unset)
-        self.marketplace.available_add_ons(sid)
-      end
-
       ##
       # @param [String] sid 34 character string that uniquely identifies the Add-on.
       #   This Sid can also be found in the Console on that specific Add-ons page as the
@@ -152,6 +144,14 @@ module Twilio
         self.marketplace.installed_add_ons(sid)
       end
 
+      ##
+      # @param [String] sid A 34 character string that uniquely identifies this Add-on.
+      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnInstance] if sid was passed.
+      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
+      def available_add_ons(sid=:unset)
+        self.marketplace.available_add_ons(sid)
+      end
+
       ##
       # @param [String] sid The sid
       # @return [Twilio::REST::Preview::Sync::ServiceInstance] if sid was passed.

data/lib/twilio-ruby/rest/preview/marketplace.rb

@@ -15,37 +15,37 @@ module Twilio
         def initialize(domain)
           super
           @version = 'marketplace'
-          @available_add_ons = nil
           @installed_add_ons = nil
+          @available_add_ons = nil
         end
 
         ##
-        # @param [String] sid The Available Add-on Sid that uniquely identifies this
+        # @param [String] sid The Installed Add-on Sid that uniquely identifies this
         #   resource
-        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
-        def available_add_ons(sid=:unset)
+        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnContext] if sid was passed.
+        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnList]
+        def installed_add_ons(sid=:unset)
           if sid.nil?
             raise ArgumentError, 'sid cannot be nil'
           elsif sid == :unset
-            @available_add_ons ||= AvailableAddOnList.new self
+            @installed_add_ons ||= InstalledAddOnList.new self
           else
-            AvailableAddOnContext.new(self, sid)
+            InstalledAddOnContext.new(self, sid)
           end
         end
 
         ##
-        # @param [String] sid The Installed Add-on Sid that uniquely identifies this
+        # @param [String] sid The Available Add-on Sid that uniquely identifies this
         #   resource
-        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnList]
-        def installed_add_ons(sid=:unset)
+        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnContext] if sid was passed.
+        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
+        def available_add_ons(sid=:unset)
           if sid.nil?
             raise ArgumentError, 'sid cannot be nil'
           elsif sid == :unset
-            @installed_add_ons ||= InstalledAddOnList.new self
+            @available_add_ons ||= AvailableAddOnList.new self
           else
-            InstalledAddOnContext.new(self, sid)
+            AvailableAddOnContext.new(self, sid)
           end
         end