twilio-ruby 5.10.5 → 5.10.6

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

@@ -297,6 +297,7 @@ module Twilio
                   'conference_sid' => payload['conference_sid'],
                   'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
                   'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
+                  'start_time' => Twilio.deserialize_rfc2822(payload['start_time']),
                   'duration' => payload['duration'],
                   'sid' => payload['sid'],
                   'price' => payload['price'],
@@ -362,6 +363,12 @@ module Twilio
               @properties['date_updated']
             end
 
+            ##
+            # @return [Time] The start time of the recording, given in RFC 2822 format.
+            def start_time
+              @properties['start_time']
+            end
+
             ##
             # @return [String] The length of the recording, in seconds.
             def duration

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the TranscriptionList
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The unique id of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) responsible for this
+            #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
             #   transcription.
             # @return [TranscriptionList] TranscriptionList
             def initialize(version, account_sid: nil)
@@ -150,7 +150,7 @@ module Twilio
             # Initialize the TranscriptionContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The account_sid
-            # @param [String] sid The transcription Sid that uniquely identifies this resource
+            # @param [String] sid The unique SID that identifies this Transcription
             # @return [TranscriptionContext] TranscriptionContext
             def initialize(version, account_sid, sid)
               super(version)
@@ -201,9 +201,9 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] account_sid The unique id of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) responsible for this
+            #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
             #   transcription.
-            # @param [String] sid The transcription Sid that uniquely identifies this resource
+            # @param [String] sid The unique SID that identifies this Transcription
             # @return [TranscriptionInstance] TranscriptionInstance
             def initialize(version, payload, account_sid: nil, sid: nil)
               super(version)

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

@@ -365,8 +365,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid A unique 34-character string that identifies this resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::TranscriptionInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::TranscriptionList]
       def transcriptions(sid=:unset)

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
 

data/lib/twilio-ruby/rest/preview/understand/assistant/intent/field.rb

@@ -115,7 +115,10 @@ module Twilio
               ##
               # Retrieve a single page of FieldInstance records from the API.
               # Request is executed immediately.
-              # @param [String] field_type The unique name or sid of the FieldType
+              # @param [String] field_type The unique name or sid of the FieldType. It can be
+              #   any [Built-in Field
+              #   Type](https://www.twilio.com/docs/assistant/api/built-in-field-types) or the
+              #   unique_name or the Field Type sid of a custom Field Type.
               # @param [String] unique_name A user-provided string that uniquely identifies this
               #   resource as an alternative to the sid. Unique up to 64 characters long.
               # @return [FieldInstance] Newly created FieldInstance
@@ -305,7 +308,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The Field Type of this field. Can be the Field Type unique_name or the Field Type sid.
+              # @return [String] The Field Type of this field. It can be any Built-in Field Type or unique_name or the Field Type sid of a custom Field Type.
               def field_type
                 @properties['field_type']
               end

data/lib/twilio-ruby/rest/preview/understand/assistant/query.rb

@@ -35,7 +35,7 @@ module Twilio
             # @param [String] model_build The Model Build Sid or unique name of the Model
             #   Build to be queried.
             # @param [String] status A string that described the query status. The values can
-            #   be: to_review, reviewed, discarded
+            #   be: pending_review, reviewed, discarded
             # @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
@@ -61,7 +61,7 @@ module Twilio
             # @param [String] model_build The Model Build Sid or unique name of the Model
             #   Build to be queried.
             # @param [String] status A string that described the query status. The values can
-            #   be: to_review, reviewed, discarded
+            #   be: pending_review, reviewed, discarded
             # @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,7 +103,7 @@ module Twilio
             # @param [String] model_build The Model Build Sid or unique name of the Model
             #   Build to be queried.
             # @param [String] status A string that described the query status. The values can
-            #   be: to_review, reviewed, discarded
+            #   be: pending_review, reviewed, discarded
             # @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
@@ -245,7 +245,7 @@ module Twilio
             # Update the QueryInstance
             # @param [String] sample_sid The sample_sid
             # @param [String] status A string that described the query status. The values can
-            #   be: to_review, reviewed, discarded
+            #   be: pending_review, reviewed, discarded
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)
               data = Twilio::Values.of({'SampleSid' => sample_sid, 'Status' => status, })
@@ -357,7 +357,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The query
+            # @return [String] The end-user's natural language input.
             def query
               @properties['query']
             end
@@ -381,7 +381,7 @@ module Twilio
             end
 
             ##
-            # @return [String] A string that described the query status. The values can be: to_review, reviewed, discarded
+            # @return [String] A string that described the query status. The values can be: pending_review, reviewed, discarded
             def status
               @properties['status']
             end
@@ -393,7 +393,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The source_channel
+            # @return [String] The communication channel where this end-user input came from
             def source_channel
               @properties['source_channel']
             end
@@ -409,7 +409,7 @@ module Twilio
             # Update the QueryInstance
             # @param [String] sample_sid The sample_sid
             # @param [String] status A string that described the query status. The values can
-            #   be: to_review, reviewed, discarded
+            #   be: pending_review, reviewed, discarded
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)
               context.update(sample_sid: sample_sid, status: status, )

data/lib/twilio-ruby/rest/proxy/v1/service.rb

@@ -111,10 +111,10 @@ module Twilio
           # Retrieve a single page of ServiceInstance records from the API.
           # Request is executed immediately.
           # @param [String] unique_name The human-readable string that uniquely identifies
-          #   this Service, up to 64 characters.
+          #   this Service, up to 64 characters. *Should not contain PII.*
           # @param [String] default_ttl The default time delay in seconds after the latest
           #   of Session create time or the Session's last Interaction time, after which a
-          #   session will expire.  Used for sessions where ttl is not specified.
+          #   session will expire.  Used for sessions where TTL is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
           # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected
@@ -232,11 +232,11 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] unique_name A human readable description of this resource, up to
-          #   64 characters.
+          # @param [String] unique_name A human-readable description of this resource, up to
+          #   64 characters. *Should not contain PII.*
           # @param [String] default_ttl The default time delay in seconds after the latest
           #   of Session create time or the Session's last Interaction time, after which a
-          #   session will expire.  Used for sessions where ttl is not specified.
+          #   session will expire.  Used for sessions where TTL is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
           # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected
@@ -385,7 +385,7 @@ module Twilio
           end
 
           ##
-          # @return [String] A human readable description of this resource.
+          # @return [String] A human-readable description of this resource.
           def unique_name
             @properties['unique_name']
           end
@@ -472,11 +472,11 @@ module Twilio
 
           ##
           # Update the ServiceInstance
-          # @param [String] unique_name A human readable description of this resource, up to
-          #   64 characters.
+          # @param [String] unique_name A human-readable description of this resource, up to
+          #   64 characters. *Should not contain PII.*
           # @param [String] default_ttl The default time delay in seconds after the latest
           #   of Session create time or the Session's last Interaction time, after which a
-          #   session will expire.  Used for sessions where ttl is not specified.
+          #   session will expire.  Used for sessions where TTL is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
           # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected

data/lib/twilio-ruby/rest/proxy/v1/service/phone_number.rb

@@ -31,9 +31,11 @@ module Twilio
             ##
             # Retrieve a single page of PhoneNumberInstance records from the API.
             # Request is executed immediately.
-            # @param [String] sid A 34 character string that uniquely identifies this Phone
-            #   Number.
-            # @param [String] phone_number The phone_number
+            # @param [String] sid A Twilio
+            #   [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incoming-phone-numbers) Sid that represents the Twilio Number you would like to assign to your Proxy Service (e.g. `PN1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d`).
+            # @param [String] phone_number A string that represents the Twilio Number you
+            #   would like to assign to your Proxy Service. Provide number in
+            #   [E.164](https://en.wikipedia.org/wiki/E.164) format (e.g. `+16175551212`).
             # @return [PhoneNumberInstance] Newly created PhoneNumberInstance
             def create(sid: :unset, phone_number: :unset)
               data = Twilio::Values.of({'Sid' => sid, 'PhoneNumber' => phone_number, })
@@ -175,8 +177,8 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The unique SID identifier of the parent
             #   [Service](https://www.twilio.com/docs/proxy/api/service).
-            # @param [String] sid A 34 character string that uniquely identifies this Phone
-            #   Number.
+            # @param [String] sid A 34 character string that uniquely identifies the Phone
+            #   Number to fetch (e.g. `PN1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d`).
             # @return [PhoneNumberContext] PhoneNumberContext
             def initialize(version, service_sid, sid)
               super(version)
@@ -230,8 +232,8 @@ module Twilio
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The unique SID identifier of the parent
             #   [Service](https://www.twilio.com/docs/proxy/api/service).
-            # @param [String] sid A 34 character string that uniquely identifies this Phone
-            #   Number.
+            # @param [String] sid A 34 character string that uniquely identifies the Phone
+            #   Number to fetch (e.g. `PN1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d`).
             # @return [PhoneNumberInstance] PhoneNumberInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
               super(version)
@@ -303,7 +305,7 @@ module Twilio
             end
 
             ##
-            # @return [String] A human readable description of this resource.
+            # @return [String] A human-readable description of this resource.
             def friendly_name
               @properties['friendly_name']
             end

data/lib/twilio-ruby/rest/proxy/v1/service/session.rb

@@ -124,7 +124,7 @@ module Twilio
             # Retrieve a single page of SessionInstance records from the API.
             # Request is executed immediately.
             # @param [String] unique_name Your unique identifier for this Session such as a
-            #   Job ID or conversation ID. Should not contain PII.
+            #   Job ID or conversation ID. *Should not contain PII.*
             # @param [Time] date_expiry An absolute time (ISO 8601) at which this Session
             #   should close. If this is populated, it takes precedence over TTL values.
             # @param [String] ttl The time, in seconds, after the latest of Session create
@@ -240,7 +240,6 @@ module Twilio
 
             ##
             # Update the SessionInstance
-            # @param [String] unique_name The unique_name
             # @param [Time] date_expiry The date that this Session should expire, given in ISO
             #   8601 format.
             # @param [String] ttl The time, in seconds, after the latest of Session create
@@ -250,9 +249,8 @@ module Twilio
             #   to re-open a session or `closed` to close a session.
             # @param [Hash] participants The participants
             # @return [SessionInstance] Updated SessionInstance
-            def update(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
+            def update(date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
               data = Twilio::Values.of({
-                  'UniqueName' => unique_name,
                   'DateExpiry' => Twilio.serialize_iso8601_datetime(date_expiry),
                   'Ttl' => ttl,
                   'Mode' => mode,
@@ -482,7 +480,6 @@ module Twilio
 
             ##
             # Update the SessionInstance
-            # @param [String] unique_name The unique_name
             # @param [Time] date_expiry The date that this Session should expire, given in ISO
             #   8601 format.
             # @param [String] ttl The time, in seconds, after the latest of Session create
@@ -492,9 +489,8 @@ module Twilio
             #   to re-open a session or `closed` to close a session.
             # @param [Hash] participants The participants
             # @return [SessionInstance] Updated SessionInstance
-            def update(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
+            def update(date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
               context.update(
-                  unique_name: unique_name,
                   date_expiry: date_expiry,
                   ttl: ttl,
                   mode: mode,

data/lib/twilio-ruby/rest/proxy/v1/service/session/participant.rb

@@ -121,7 +121,7 @@ module Twilio
               # Retrieve a single page of ParticipantInstance records from the API.
               # Request is executed immediately.
               # @param [String] identifier The phone number of this Participant.
-              # @param [String] friendly_name A human readable description of this resource, up
+              # @param [String] friendly_name A human-readable description of this resource, up
               #   to 64 characters. Should not include PII.
               # @param [String] proxy_identifier The proxy phone number to use for this
               #   Participant. If not specified, Proxy will select a number from the pool.
@@ -244,36 +244,6 @@ module Twilio
                 @version.delete('delete', @uri)
               end
 
-              ##
-              # Update the ParticipantInstance
-              # @param [String] identifier The identifier
-              # @param [String] friendly_name The friendly_name
-              # @param [String] proxy_identifier The proxy_identifier
-              # @param [String] proxy_identifier_sid The proxy_identifier_sid
-              # @return [ParticipantInstance] Updated ParticipantInstance
-              def update(identifier: :unset, friendly_name: :unset, proxy_identifier: :unset, proxy_identifier_sid: :unset)
-                data = Twilio::Values.of({
-                    'Identifier' => identifier,
-                    'FriendlyName' => friendly_name,
-                    'ProxyIdentifier' => proxy_identifier,
-                    'ProxyIdentifierSid' => proxy_identifier_sid,
-                })
-
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
-
-                ParticipantInstance.new(
-                    @version,
-                    payload,
-                    service_sid: @solution[:service_sid],
-                    session_sid: @solution[:session_sid],
-                    sid: @solution[:sid],
-                )
-              end
-
               ##
               # Access the message_interactions
               # @return [MessageInteractionList]
@@ -395,7 +365,7 @@ module Twilio
               end
 
               ##
-              # @return [String] A human readable description of this resource.
+              # @return [String] A human-readable description of this resource.
               def friendly_name
                 @properties['friendly_name']
               end
@@ -419,7 +389,7 @@ module Twilio
               end
 
               ##
-              # @return [Time] The date this Participant was deleted
+              # @return [Time] The date this Participant was removed
               def date_deleted
                 @properties['date_deleted']
               end
@@ -462,22 +432,6 @@ module Twilio
                 context.delete
               end
 
-              ##
-              # Update the ParticipantInstance
-              # @param [String] identifier The identifier
-              # @param [String] friendly_name The friendly_name
-              # @param [String] proxy_identifier The proxy_identifier
-              # @param [String] proxy_identifier_sid The proxy_identifier_sid
-              # @return [ParticipantInstance] Updated ParticipantInstance
-              def update(identifier: :unset, friendly_name: :unset, proxy_identifier: :unset, proxy_identifier_sid: :unset)
-                context.update(
-                    identifier: identifier,
-                    friendly_name: friendly_name,
-                    proxy_identifier: proxy_identifier,
-                    proxy_identifier_sid: proxy_identifier_sid,
-                )
-              end
-
               ##
               # Access the message_interactions
               # @return [message_interactions] message_interactions