twilio-ruby 5.40.3 → 5.44.0

data/lib/twilio-ruby/rest/conversations/v1/service/user.rb

@@ -11,14 +11,12 @@ module Twilio
     class Conversations < Domain
       class V1 < Version
         class ServiceContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class UserList < ListResource
             ##
             # Initialize the UserList
             # @param [Version] version Version that contains the resource
-            # @param [String] chat_service_sid The SID of the [Conversation
-            #   Service](https://www.twilio.com/docs/conversations/api/service-resource) the
+            # @param [String] chat_service_sid The SID of the {Conversation
+            #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] the
             #   User resource is associated with.
             # @return [UserList] UserList
             def initialize(version, chat_service_sid: nil)
@@ -32,26 +30,29 @@ module Twilio
             ##
             # Create the UserInstance
             # @param [String] identity The application-defined string that uniquely identifies
-            #   the resource's User within the [Conversation
-            #   Service](https://www.twilio.com/docs/conversations/api/service-resource). This
+            #   the resource's User within the {Conversation
+            #   Service}[https://www.twilio.com/docs/conversations/api/service-resource]. This
             #   value is often a username or an email address, and is case-sensitive.
             # @param [String] friendly_name The string that you assigned to describe the
             #   resource.
             # @param [String] attributes The JSON Object string that stores
             #   application-specific data. If attributes have not been set, `{}` is returned.
             # @param [String] role_sid The SID of a service-level
-            #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+            #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
             #   the user.
+            # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [UserInstance] Created UserInstance
-            def create(identity: nil, friendly_name: :unset, attributes: :unset, role_sid: :unset)
+            def create(identity: nil, friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'Identity' => identity,
                   'FriendlyName' => friendly_name,
                   'Attributes' => attributes,
                   'RoleSid' => role_sid,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.create('POST', @uri, data: data)
+              payload = @version.create('POST', @uri, data: data, headers: headers)
 
               UserInstance.new(@version, payload, chat_service_sid: @solution[:chat_service_sid], )
             end
@@ -143,8 +144,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class UserPage < Page
             ##
             # Initialize the UserPage
@@ -174,14 +173,12 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class UserContext < InstanceContext
             ##
             # Initialize the UserContext
             # @param [Version] version Version that contains the resource
-            # @param [String] chat_service_sid The SID of the [Conversation
-            #   Service](https://www.twilio.com/docs/conversations/api/service-resource) to
+            # @param [String] chat_service_sid The SID of the {Conversation
+            #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] to
             #   fetch the User resource from.
             # @param [String] sid The SID of the User resource to fetch. This value can be
             #   either the `sid` or the `identity` of the User resource to fetch.
@@ -201,17 +198,20 @@ module Twilio
             # @param [String] attributes The JSON Object string that stores
             #   application-specific data. If attributes have not been set, `{}` is returned.
             # @param [String] role_sid The SID of a service-level
-            #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+            #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
             #   the user.
+            # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [UserInstance] Updated UserInstance
-            def update(friendly_name: :unset, attributes: :unset, role_sid: :unset)
+            def update(friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'Attributes' => attributes,
                   'RoleSid' => role_sid,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.update('POST', @uri, data: data)
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
               UserInstance.new(
                   @version,
@@ -223,9 +223,13 @@ module Twilio
 
             ##
             # Delete the UserInstance
+            # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-               @version.delete('DELETE', @uri)
+            def delete(x_twilio_webhook_enabled: :unset)
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
@@ -257,15 +261,13 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class UserInstance < InstanceResource
             ##
             # Initialize the UserInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] chat_service_sid The SID of the [Conversation
-            #   Service](https://www.twilio.com/docs/conversations/api/service-resource) the
+            # @param [String] chat_service_sid The SID of the {Conversation
+            #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] the
             #   User resource is associated with.
             # @param [String] sid The SID of the User resource to fetch. This value can be
             #   either the `sid` or the `identity` of the User resource to fetch.
@@ -365,7 +367,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The absolute URL of the User resource
+            # @return [String] An absolute URL for this user.
             def url
               @properties['url']
             end
@@ -377,18 +379,27 @@ module Twilio
             # @param [String] attributes The JSON Object string that stores
             #   application-specific data. If attributes have not been set, `{}` is returned.
             # @param [String] role_sid The SID of a service-level
-            #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+            #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
             #   the user.
+            # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [UserInstance] Updated UserInstance
-            def update(friendly_name: :unset, attributes: :unset, role_sid: :unset)
-              context.update(friendly_name: friendly_name, attributes: attributes, role_sid: role_sid, )
+            def update(friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
+              context.update(
+                  friendly_name: friendly_name,
+                  attributes: attributes,
+                  role_sid: role_sid,
+                  x_twilio_webhook_enabled: x_twilio_webhook_enabled,
+              )
             end
 
             ##
             # Delete the UserInstance
+            # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
+            def delete(x_twilio_webhook_enabled: :unset)
+              context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
             end
 
             ##

data/lib/twilio-ruby/rest/conversations/v1/user.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Conversations < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class UserList < ListResource
           ##
           # Initialize the UserList
@@ -28,26 +26,29 @@ module Twilio
           ##
           # Create the UserInstance
           # @param [String] identity The application-defined string that uniquely identifies
-          #   the resource's User within the [Conversation
-          #   Service](https://www.twilio.com/docs/conversations/api/service-resource). This
+          #   the resource's User within the {Conversation
+          #   Service}[https://www.twilio.com/docs/conversations/api/service-resource]. This
           #   value is often a username or an email address, and is case-sensitive.
           # @param [String] friendly_name The string that you assigned to describe the
           #   resource.
           # @param [String] attributes The JSON Object string that stores
           #   application-specific data. If attributes have not been set, `{}` is returned.
           # @param [String] role_sid The SID of a service-level
-          #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+          #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
           #   the user.
+          # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [UserInstance] Created UserInstance
-          def create(identity: nil, friendly_name: :unset, attributes: :unset, role_sid: :unset)
+          def create(identity: nil, friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
             data = Twilio::Values.of({
                 'Identity' => identity,
                 'FriendlyName' => friendly_name,
                 'Attributes' => attributes,
                 'RoleSid' => role_sid,
             })
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-            payload = @version.create('POST', @uri, data: data)
+            payload = @version.create('POST', @uri, data: data, headers: headers)
 
             UserInstance.new(@version, payload, )
           end
@@ -139,8 +140,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class UserPage < Page
           ##
           # Initialize the UserPage
@@ -170,8 +169,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class UserContext < InstanceContext
           ##
           # Initialize the UserContext
@@ -194,26 +191,33 @@ module Twilio
           # @param [String] attributes The JSON Object string that stores
           #   application-specific data. If attributes have not been set, `{}` is returned.
           # @param [String] role_sid The SID of a service-level
-          #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+          #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
           #   the user.
+          # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [UserInstance] Updated UserInstance
-          def update(friendly_name: :unset, attributes: :unset, role_sid: :unset)
+          def update(friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'Attributes' => attributes,
                 'RoleSid' => role_sid,
             })
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-            payload = @version.update('POST', @uri, data: data)
+            payload = @version.update('POST', @uri, data: data, headers: headers)
 
             UserInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Delete the UserInstance
+          # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [Boolean] true if delete succeeds, false otherwise
-          def delete
-             @version.delete('DELETE', @uri)
+          def delete(x_twilio_webhook_enabled: :unset)
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+             @version.delete('DELETE', @uri, headers: headers)
           end
 
           ##
@@ -240,8 +244,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class UserInstance < InstanceResource
           ##
           # Initialize the UserInstance
@@ -345,7 +347,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The absolute URL of the User resource
+          # @return [String] An absolute URL for this user.
           def url
             @properties['url']
           end
@@ -357,18 +359,27 @@ module Twilio
           # @param [String] attributes The JSON Object string that stores
           #   application-specific data. If attributes have not been set, `{}` is returned.
           # @param [String] role_sid The SID of a service-level
-          #   [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to
+          #   {Role}[https://www.twilio.com/docs/conversations/api/role-resource] to assign to
           #   the user.
+          # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [UserInstance] Updated UserInstance
-          def update(friendly_name: :unset, attributes: :unset, role_sid: :unset)
-            context.update(friendly_name: friendly_name, attributes: attributes, role_sid: role_sid, )
+          def update(friendly_name: :unset, attributes: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
+            context.update(
+                friendly_name: friendly_name,
+                attributes: attributes,
+                role_sid: role_sid,
+                x_twilio_webhook_enabled: x_twilio_webhook_enabled,
+            )
           end
 
           ##
           # Delete the UserInstance
+          # @param [user.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
           # @return [Boolean] true if delete succeeds, false otherwise
-          def delete
-            context.delete
+          def delete(x_twilio_webhook_enabled: :unset)
+            context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
           end
 
           ##

data/lib/twilio-ruby/rest/events/v1/subscription.rb

@@ -29,6 +29,8 @@ module Twilio
           # Lists SubscriptionInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
+          # @param [String] sink_sid The SID of the sink that the list of Subscriptions
+          #   should be filtered by.
           # @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
@@ -36,14 +38,16 @@ module Twilio
           #    but a limit is defined, stream() will attempt to read the limit with the most
           #    efficient page size, i.e. min(limit, 1000)
           # @return [Array] Array of up to limit results
-          def list(limit: nil, page_size: nil)
-            self.stream(limit: limit, page_size: page_size).entries
+          def list(sink_sid: :unset, limit: nil, page_size: nil)
+            self.stream(sink_sid: sink_sid, limit: limit, page_size: page_size).entries
           end
 
           ##
           # Streams SubscriptionInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
+          # @param [String] sink_sid The SID of the sink that the list of Subscriptions
+          #   should be filtered by.
           # @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
@@ -51,10 +55,10 @@ module Twilio
           #    but a limit is defined, stream() will attempt to read the limit with the most
           #    efficient page size, i.e. min(limit, 1000)
           # @return [Enumerable] Enumerable that will yield up to limit results
-          def stream(limit: nil, page_size: nil)
+          def stream(sink_sid: :unset, limit: nil, page_size: nil)
             limits = @version.read_limits(limit, page_size)
 
-            page = self.page(page_size: limits[:page_size], )
+            page = self.page(sink_sid: sink_sid, page_size: limits[:page_size], )
 
             @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
           end
@@ -76,12 +80,15 @@ module Twilio
           ##
           # Retrieve a single page of SubscriptionInstance records from the API.
           # Request is executed immediately.
+          # @param [String] sink_sid The SID of the sink that the list of Subscriptions
+          #   should be filtered by.
           # @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
           # @return [Page] Page of SubscriptionInstance
-          def page(page_token: :unset, page_number: :unset, page_size: :unset)
+          def page(sink_sid: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
             params = Twilio::Values.of({
+                'SinkSid' => sink_sid,
                 'PageToken' => page_token,
                 'Page' => page_number,
                 'PageSize' => page_size,

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

@@ -30,15 +30,15 @@ module Twilio
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
           # @param [String] from Retrieve only those faxes sent from this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [String] to Retrieve only those faxes sent to this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [Time] date_created_on_or_before Retrieve only those faxes with a
-          #   `date_created` that is before or equal to this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   `date_created` that is before or equal to this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @param [Time] date_created_after Retrieve only those faxes with a `date_created`
-          #   that is later than this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   that is later than this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @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
@@ -62,15 +62,15 @@ module Twilio
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
           # @param [String] from Retrieve only those faxes sent from this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [String] to Retrieve only those faxes sent to this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [Time] date_created_on_or_before Retrieve only those faxes with a
-          #   `date_created` that is before or equal to this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   `date_created` that is before or equal to this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @param [Time] date_created_after Retrieve only those faxes with a `date_created`
-          #   that is later than this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   that is later than this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @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
@@ -110,15 +110,15 @@ module Twilio
           # Retrieve a single page of FaxInstance records from the API.
           # Request is executed immediately.
           # @param [String] from Retrieve only those faxes sent from this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [String] to Retrieve only those faxes sent to this phone number,
-          #   specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
+          #   specified in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format.
           # @param [Time] date_created_on_or_before Retrieve only those faxes with a
-          #   `date_created` that is before or equal to this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   `date_created` that is before or equal to this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @param [Time] date_created_after Retrieve only those faxes with a `date_created`
-          #   that is later than this value, specified in [ISO
-          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          #   that is later than this value, specified in {ISO
+          #   8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
           # @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
@@ -155,21 +155,21 @@ module Twilio
           ##
           # Create the FaxInstance
           # @param [String] to The phone number to receive the fax in
-          #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format or the
+          #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format or the
           #   recipient's SIP URI.
           # @param [String] media_url The URL of the PDF that contains the fax. See our
-          #   [security](https://www.twilio.com/docs/usage/security) page for information on
+          #   {security}[https://www.twilio.com/docs/usage/security] page for information on
           #   how to ensure the request for your media comes from Twilio.
-          # @param [fax.Quality] quality The [Fax Quality
-          #   value](https://www.twilio.com/docs/fax/api/fax-resource#fax-quality-values) that
+          # @param [fax.Quality] quality The {Fax Quality
+          #   value}[https://www.twilio.com/docs/fax/api/fax-resource#fax-quality-values] that
           #   describes the fax quality. Can be: `standard`, `fine`, or `superfine` and
           #   defaults to `fine`.
           # @param [String] status_callback The URL we should call using the `POST` method
-          #   to send [status
-          #   information](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-callback)
+          #   to send {status
+          #   information}[https://www.twilio.com/docs/fax/api/fax-resource#fax-status-callback]
           #   to your application when the status of the fax changes.
           # @param [String] from The number the fax was sent from. Can be the phone number
-          #   in [E.164](https://www.twilio.com/docs/glossary/what-e164) format or the SIP
+          #   in {E.164}[https://www.twilio.com/docs/glossary/what-e164] format or the SIP
           #   `from` value. The caller ID displayed to the recipient uses this value. If this
           #   is a phone number, it must be a Twilio number or a verified outgoing caller id
           #   from your account. If `to` is a SIP address, this can be any alphanumeric string
@@ -273,7 +273,7 @@ module Twilio
           ##
           # Update the FaxInstance
           # @param [fax.UpdateStatus] status The new
-          #   [status](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values) of
+          #   {status}[https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values] of
           #   the resource. Can be only `canceled`. This may fail if transmission has already
           #   started.
           # @return [FaxInstance] Updated FaxInstance
@@ -494,7 +494,7 @@ module Twilio
           ##
           # Update the FaxInstance
           # @param [fax.UpdateStatus] status The new
-          #   [status](https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values) of
+          #   {status}[https://www.twilio.com/docs/fax/api/fax-resource#fax-status-values] of
           #   the resource. Can be only `canceled`. This may fail if transmission has already
           #   started.
           # @return [FaxInstance] Updated FaxInstance