twilio-ruby 5.40.3 → 5.74.1

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/task/reservation.rb

@@ -35,6 +35,7 @@ module Twilio
               # @param [reservation.Status] reservation_status Returns the list of reservations
               #   for a task with a specified ReservationStatus.  Can be: `pending`, `accepted`,
               #   `rejected`, or `timeout`.
+              # @param [String] worker_sid The SID of the reserved Worker resource to read.
               # @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
@@ -42,8 +43,13 @@ 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(reservation_status: :unset, limit: nil, page_size: nil)
-                self.stream(reservation_status: reservation_status, limit: limit, page_size: page_size).entries
+              def list(reservation_status: :unset, worker_sid: :unset, limit: nil, page_size: nil)
+                self.stream(
+                    reservation_status: reservation_status,
+                    worker_sid: worker_sid,
+                    limit: limit,
+                    page_size: page_size
+                ).entries
               end
 
               ##
@@ -53,6 +59,7 @@ module Twilio
               # @param [reservation.Status] reservation_status Returns the list of reservations
               #   for a task with a specified ReservationStatus.  Can be: `pending`, `accepted`,
               #   `rejected`, or `timeout`.
+              # @param [String] worker_sid The SID of the reserved Worker resource to read.
               # @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
@@ -60,10 +67,14 @@ 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(reservation_status: :unset, limit: nil, page_size: nil)
+              def stream(reservation_status: :unset, worker_sid: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(reservation_status: reservation_status, page_size: limits[:page_size], )
+                page = self.page(
+                    reservation_status: reservation_status,
+                    worker_sid: worker_sid,
+                    page_size: limits[:page_size],
+                )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -88,13 +99,15 @@ module Twilio
               # @param [reservation.Status] reservation_status Returns the list of reservations
               #   for a task with a specified ReservationStatus.  Can be: `pending`, `accepted`,
               #   `rejected`, or `timeout`.
+              # @param [String] worker_sid The SID of the reserved Worker resource to read.
               # @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 ReservationInstance
-              def page(reservation_status: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+              def page(reservation_status: :unset, worker_sid: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
                 params = Twilio::Values.of({
                     'ReservationStatus' => reservation_status,
+                    'WorkerSid' => worker_sid,
                     'PageToken' => page_token,
                     'Page' => page_number,
                     'PageSize' => page_size,
@@ -209,7 +222,7 @@ module Twilio
               #   instruction.
               # @param [String] dequeue_to The Contact URI of the worker when executing a
               #   Dequeue instruction. Can be the URI of the Twilio Client, the SIP URI for
-              #   Programmable SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164)
+              #   Programmable SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164]
               #   formatted phone number, depending on the destination.
               # @param [String] dequeue_status_callback_url The Callback URL for completed call
               #   event when executing a Dequeue instruction.
@@ -220,7 +233,7 @@ module Twilio
               # @param [String] call_timeout Timeout for call when executing a Call instruction.
               # @param [String] call_to The Contact URI of the worker when executing a Call
               #   instruction.  Can be the URI of the Twilio Client, the SIP URI for Programmable
-              #   SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted
+              #   SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164] formatted
               #   phone number, depending on the destination.
               # @param [String] call_url TwiML URI executed on answering the worker's leg as a
               #   result of the Call instruction.
@@ -236,7 +249,7 @@ module Twilio
               #   the Redirect instruction.
               # @param [String] to The Contact URI of the worker when executing a Conference
               #   instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable
-              #   SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted
+              #   SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164] formatted
               #   phone number, depending on the destination.
               # @param [String] from The Caller ID of the call to the worker when executing a
               #   Conference instruction.
@@ -244,8 +257,8 @@ module Twilio
               #   `status_callback_method` to send status information to your application.
               # @param [String] status_callback_method The HTTP method we should use to call
               #   `status_callback`. Can be: `POST` or `GET` and the default is `POST`.
-              # @param [reservation.CallStatus] status_callback_event The call progress events
-              #   that we will send to `status_callback`. Can be: `initiated`, `ringing`,
+              # @param [Array[reservation.CallStatus]] status_callback_event The call progress
+              #   events that we will send to `status_callback`. Can be: `initiated`, `ringing`,
               #   `answered`, or `completed`.
               # @param [String] timeout Timeout for call when executing a Conference
               #   instruction.
@@ -264,8 +277,8 @@ module Twilio
               #   agent leaves.
               # @param [String] wait_url The URL we should call using the `wait_method` for the
               #   music to play while participants are waiting for the conference to start. The
-              #   default value is the URL of our standard hold music. [Learn more about hold
-              #   music](https://www.twilio.com/labs/twimlets/holdmusic).
+              #   default value is the URL of our standard hold music. {Learn more about hold
+              #   music}[https://www.twilio.com/labs/twimlets/holdmusic].
               # @param [String] wait_method The HTTP method we should use to call `wait_url`.
               #   Can be `GET` or `POST` and the default is `POST`. When using a static audio
               #   file, this should be `GET` so that we can cache the file.
@@ -282,7 +295,7 @@ module Twilio
               # @param [String] conference_status_callback_method The HTTP method we should use
               #   to call `conference_status_callback`. Can be: `GET` or `POST` and defaults to
               #   `POST`.
-              # @param [reservation.ConferenceEvent] conference_status_callback_event The
+              # @param [Array[reservation.ConferenceEvent]] conference_status_callback_event The
               #   conference status events that we will send to `conference_status_callback`. Can
               #   be: `start`, `end`, `join`, `leave`, `mute`, `hold`, `speaker`.
               # @param [String] conference_record Whether to record the conference the
@@ -305,13 +318,13 @@ module Twilio
               #   should use to call `conference_recording_status_callback`. Can be: `GET` or
               #   `POST` and defaults to `POST`.
               # @param [String] region The
-              #   [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls)
+              #   {region}[https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls]
               #   where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`,
               #   `br1`, `au1`, or `jp1`.
               # @param [String] sip_auth_username The SIP username used for authentication.
               # @param [String] sip_auth_password The SIP password for authentication.
-              # @param [String] dequeue_status_callback_event The Call progress events sent via
-              #   webhooks as a result of a Dequeue instruction.
+              # @param [Array[String]] dequeue_status_callback_event The Call progress events
+              #   sent via webhooks as a result of a Dequeue instruction.
               # @param [String] post_work_activity_sid The new worker activity SID after
               #   executing a Conference instruction.
               # @param [reservation.SupervisorMode] supervisor_mode The Supervisor mode when
@@ -322,8 +335,9 @@ module Twilio
               #   when the customer leaves.
               # @param [Boolean] beep_on_customer_entrance Whether to play a notification beep
               #   when the customer joins.
+              # @param [String] if_match The If-Match HTTP request header
               # @return [ReservationInstance] Updated ReservationInstance
-              def update(reservation_status: :unset, worker_activity_sid: :unset, instruction: :unset, dequeue_post_work_activity_sid: :unset, dequeue_from: :unset, dequeue_record: :unset, dequeue_timeout: :unset, dequeue_to: :unset, dequeue_status_callback_url: :unset, call_from: :unset, call_record: :unset, call_timeout: :unset, call_to: :unset, call_url: :unset, call_status_callback_url: :unset, call_accept: :unset, redirect_call_sid: :unset, redirect_accept: :unset, redirect_url: :unset, to: :unset, from: :unset, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, conference_record: :unset, conference_trim: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, region: :unset, sip_auth_username: :unset, sip_auth_password: :unset, dequeue_status_callback_event: :unset, post_work_activity_sid: :unset, supervisor_mode: :unset, supervisor: :unset, end_conference_on_customer_exit: :unset, beep_on_customer_entrance: :unset)
+              def update(reservation_status: :unset, worker_activity_sid: :unset, instruction: :unset, dequeue_post_work_activity_sid: :unset, dequeue_from: :unset, dequeue_record: :unset, dequeue_timeout: :unset, dequeue_to: :unset, dequeue_status_callback_url: :unset, call_from: :unset, call_record: :unset, call_timeout: :unset, call_to: :unset, call_url: :unset, call_status_callback_url: :unset, call_accept: :unset, redirect_call_sid: :unset, redirect_accept: :unset, redirect_url: :unset, to: :unset, from: :unset, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, conference_record: :unset, conference_trim: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, region: :unset, sip_auth_username: :unset, sip_auth_password: :unset, dequeue_status_callback_event: :unset, post_work_activity_sid: :unset, supervisor_mode: :unset, supervisor: :unset, end_conference_on_customer_exit: :unset, beep_on_customer_entrance: :unset, if_match: :unset)
                 data = Twilio::Values.of({
                     'ReservationStatus' => reservation_status,
                     'WorkerActivitySid' => worker_activity_sid,
@@ -379,8 +393,9 @@ module Twilio
                     'EndConferenceOnCustomerExit' => end_conference_on_customer_exit,
                     'BeepOnCustomerEntrance' => beep_on_customer_entrance,
                 })
+                headers = Twilio::Values.of({'If-Match' => if_match, })
 
-                payload = @version.update('POST', @uri, data: data)
+                payload = @version.update('POST', @uri, data: data, headers: headers)
 
                 ReservationInstance.new(
                     @version,
@@ -549,7 +564,7 @@ module Twilio
               #   instruction.
               # @param [String] dequeue_to The Contact URI of the worker when executing a
               #   Dequeue instruction. Can be the URI of the Twilio Client, the SIP URI for
-              #   Programmable SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164)
+              #   Programmable SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164]
               #   formatted phone number, depending on the destination.
               # @param [String] dequeue_status_callback_url The Callback URL for completed call
               #   event when executing a Dequeue instruction.
@@ -560,7 +575,7 @@ module Twilio
               # @param [String] call_timeout Timeout for call when executing a Call instruction.
               # @param [String] call_to The Contact URI of the worker when executing a Call
               #   instruction.  Can be the URI of the Twilio Client, the SIP URI for Programmable
-              #   SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted
+              #   SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164] formatted
               #   phone number, depending on the destination.
               # @param [String] call_url TwiML URI executed on answering the worker's leg as a
               #   result of the Call instruction.
@@ -576,7 +591,7 @@ module Twilio
               #   the Redirect instruction.
               # @param [String] to The Contact URI of the worker when executing a Conference
               #   instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable
-              #   SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted
+              #   SIP, or the {E.164}[https://www.twilio.com/docs/glossary/what-e164] formatted
               #   phone number, depending on the destination.
               # @param [String] from The Caller ID of the call to the worker when executing a
               #   Conference instruction.
@@ -584,8 +599,8 @@ module Twilio
               #   `status_callback_method` to send status information to your application.
               # @param [String] status_callback_method The HTTP method we should use to call
               #   `status_callback`. Can be: `POST` or `GET` and the default is `POST`.
-              # @param [reservation.CallStatus] status_callback_event The call progress events
-              #   that we will send to `status_callback`. Can be: `initiated`, `ringing`,
+              # @param [Array[reservation.CallStatus]] status_callback_event The call progress
+              #   events that we will send to `status_callback`. Can be: `initiated`, `ringing`,
               #   `answered`, or `completed`.
               # @param [String] timeout Timeout for call when executing a Conference
               #   instruction.
@@ -604,8 +619,8 @@ module Twilio
               #   agent leaves.
               # @param [String] wait_url The URL we should call using the `wait_method` for the
               #   music to play while participants are waiting for the conference to start. The
-              #   default value is the URL of our standard hold music. [Learn more about hold
-              #   music](https://www.twilio.com/labs/twimlets/holdmusic).
+              #   default value is the URL of our standard hold music. {Learn more about hold
+              #   music}[https://www.twilio.com/labs/twimlets/holdmusic].
               # @param [String] wait_method The HTTP method we should use to call `wait_url`.
               #   Can be `GET` or `POST` and the default is `POST`. When using a static audio
               #   file, this should be `GET` so that we can cache the file.
@@ -622,7 +637,7 @@ module Twilio
               # @param [String] conference_status_callback_method The HTTP method we should use
               #   to call `conference_status_callback`. Can be: `GET` or `POST` and defaults to
               #   `POST`.
-              # @param [reservation.ConferenceEvent] conference_status_callback_event The
+              # @param [Array[reservation.ConferenceEvent]] conference_status_callback_event The
               #   conference status events that we will send to `conference_status_callback`. Can
               #   be: `start`, `end`, `join`, `leave`, `mute`, `hold`, `speaker`.
               # @param [String] conference_record Whether to record the conference the
@@ -645,13 +660,13 @@ module Twilio
               #   should use to call `conference_recording_status_callback`. Can be: `GET` or
               #   `POST` and defaults to `POST`.
               # @param [String] region The
-              #   [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls)
+              #   {region}[https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls]
               #   where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`,
               #   `br1`, `au1`, or `jp1`.
               # @param [String] sip_auth_username The SIP username used for authentication.
               # @param [String] sip_auth_password The SIP password for authentication.
-              # @param [String] dequeue_status_callback_event The Call progress events sent via
-              #   webhooks as a result of a Dequeue instruction.
+              # @param [Array[String]] dequeue_status_callback_event The Call progress events
+              #   sent via webhooks as a result of a Dequeue instruction.
               # @param [String] post_work_activity_sid The new worker activity SID after
               #   executing a Conference instruction.
               # @param [reservation.SupervisorMode] supervisor_mode The Supervisor mode when
@@ -662,8 +677,9 @@ module Twilio
               #   when the customer leaves.
               # @param [Boolean] beep_on_customer_entrance Whether to play a notification beep
               #   when the customer joins.
+              # @param [String] if_match The If-Match HTTP request header
               # @return [ReservationInstance] Updated ReservationInstance
-              def update(reservation_status: :unset, worker_activity_sid: :unset, instruction: :unset, dequeue_post_work_activity_sid: :unset, dequeue_from: :unset, dequeue_record: :unset, dequeue_timeout: :unset, dequeue_to: :unset, dequeue_status_callback_url: :unset, call_from: :unset, call_record: :unset, call_timeout: :unset, call_to: :unset, call_url: :unset, call_status_callback_url: :unset, call_accept: :unset, redirect_call_sid: :unset, redirect_accept: :unset, redirect_url: :unset, to: :unset, from: :unset, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, conference_record: :unset, conference_trim: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, region: :unset, sip_auth_username: :unset, sip_auth_password: :unset, dequeue_status_callback_event: :unset, post_work_activity_sid: :unset, supervisor_mode: :unset, supervisor: :unset, end_conference_on_customer_exit: :unset, beep_on_customer_entrance: :unset)
+              def update(reservation_status: :unset, worker_activity_sid: :unset, instruction: :unset, dequeue_post_work_activity_sid: :unset, dequeue_from: :unset, dequeue_record: :unset, dequeue_timeout: :unset, dequeue_to: :unset, dequeue_status_callback_url: :unset, call_from: :unset, call_record: :unset, call_timeout: :unset, call_to: :unset, call_url: :unset, call_status_callback_url: :unset, call_accept: :unset, redirect_call_sid: :unset, redirect_accept: :unset, redirect_url: :unset, to: :unset, from: :unset, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, conference_record: :unset, conference_trim: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, region: :unset, sip_auth_username: :unset, sip_auth_password: :unset, dequeue_status_callback_event: :unset, post_work_activity_sid: :unset, supervisor_mode: :unset, supervisor: :unset, end_conference_on_customer_exit: :unset, beep_on_customer_entrance: :unset, if_match: :unset)
                 context.update(
                     reservation_status: reservation_status,
                     worker_activity_sid: worker_activity_sid,
@@ -718,6 +734,7 @@ module Twilio
                     supervisor: supervisor,
                     end_conference_on_customer_exit: end_conference_on_customer_exit,
                     beep_on_customer_entrance: beep_on_customer_entrance,
+                    if_match: if_match,
                 )
               end
 

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/task.rb

@@ -31,9 +31,10 @@ module Twilio
             # memory before returning.
             # @param [String] priority The priority value of the Tasks to read. Returns the
             #   list of all Tasks in the Workspace with the specified priority.
-            # @param [String] assignment_status The `assignment_status` of the Tasks to read.
-            #   Can be: `pending`, `reserved`, `assigned`, `canceled`, and `completed`. Returns
-            #   all Tasks in the Workspace with the specified `assignment_status`.
+            # @param [Array[String]] assignment_status The `assignment_status` of the Tasks
+            #   you want to read. Can be: `pending`, `reserved`, `assigned`, `canceled`,
+            #   `wrapping`, or `completed`. Returns all Tasks in the Workspace with the
+            #   specified `assignment_status`.
             # @param [String] workflow_sid The SID of the Workflow with the Tasks to read.
             #   Returns the Tasks controlled by the Workflow identified by this SID.
             # @param [String] workflow_name The friendly name of the Workflow with the Tasks
@@ -85,9 +86,10 @@ module Twilio
             # is reached.
             # @param [String] priority The priority value of the Tasks to read. Returns the
             #   list of all Tasks in the Workspace with the specified priority.
-            # @param [String] assignment_status The `assignment_status` of the Tasks to read.
-            #   Can be: `pending`, `reserved`, `assigned`, `canceled`, and `completed`. Returns
-            #   all Tasks in the Workspace with the specified `assignment_status`.
+            # @param [Array[String]] assignment_status The `assignment_status` of the Tasks
+            #   you want to read. Can be: `pending`, `reserved`, `assigned`, `canceled`,
+            #   `wrapping`, or `completed`. Returns all Tasks in the Workspace with the
+            #   specified `assignment_status`.
             # @param [String] workflow_sid The SID of the Workflow with the Tasks to read.
             #   Returns the Tasks controlled by the Workflow identified by this SID.
             # @param [String] workflow_name The friendly name of the Workflow with the Tasks
@@ -155,9 +157,10 @@ module Twilio
             # Request is executed immediately.
             # @param [String] priority The priority value of the Tasks to read. Returns the
             #   list of all Tasks in the Workspace with the specified priority.
-            # @param [String] assignment_status The `assignment_status` of the Tasks to read.
-            #   Can be: `pending`, `reserved`, `assigned`, `canceled`, and `completed`. Returns
-            #   all Tasks in the Workspace with the specified `assignment_status`.
+            # @param [Array[String]] assignment_status The `assignment_status` of the Tasks
+            #   you want to read. Can be: `pending`, `reserved`, `assigned`, `canceled`,
+            #   `wrapping`, or `completed`. Returns all Tasks in the Workspace with the
+            #   specified `assignment_status`.
             # @param [String] workflow_sid The SID of the Workflow with the Tasks to read.
             #   Returns the Tasks controlled by the Workflow identified by this SID.
             # @param [String] workflow_name The friendly name of the Workflow with the Tasks
@@ -220,10 +223,10 @@ module Twilio
 
             ##
             # Create the TaskInstance
-            # @param [String] timeout The amount of time in seconds the new task is allowed to
-            #   live. Can be up to a maximum of 2 weeks (1,209,600 seconds). The default value
-            #   is 24 hours (86,400 seconds). On timeout, the `task.canceled` event will fire
-            #   with description `Task TTL Exceeded`.
+            # @param [String] timeout The amount of time in seconds the new task can live
+            #   before being assigned. Can be up to a maximum of 2 weeks (1,209,600 seconds).
+            #   The default value is 24 hours (86,400 seconds). On timeout, the `task.canceled`
+            #   event will fire with description `Task TTL Exceeded`.
             # @param [String] priority The priority to assign the new task and override the
             #   default. When supplied, the new Task will have this priority unless it matches a
             #   Workflow Target with a Priority set. When not supplied, the new Task will have
@@ -334,8 +337,13 @@ module Twilio
             # @param [String] task_channel When MultiTasking is enabled, specify the
             #   TaskChannel with the task to update. Can be the TaskChannel's SID or its
             #   `unique_name`, such as `voice`, `sms`, or `default`.
+            # @param [String] if_match If provided, applies this mutation if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [TaskInstance] Updated TaskInstance
-            def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset)
+            def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset, if_match: :unset)
               data = Twilio::Values.of({
                   'Attributes' => attributes,
                   'AssignmentStatus' => assignment_status,
@@ -343,17 +351,25 @@ module Twilio
                   'Priority' => priority,
                   'TaskChannel' => task_channel,
               })
+              headers = Twilio::Values.of({'If-Match' => if_match, })
 
-              payload = @version.update('POST', @uri, data: data)
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
               TaskInstance.new(@version, payload, workspace_sid: @solution[:workspace_sid], sid: @solution[:sid], )
             end
 
             ##
             # Delete the TaskInstance
+            # @param [String] if_match If provided, deletes this Task if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-               @version.delete('DELETE', @uri)
+            def delete(if_match: :unset)
+              headers = Twilio::Values.of({'If-Match' => if_match, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
@@ -407,21 +423,21 @@ module Twilio
               # Marshaled Properties
               @properties = {
                   'account_sid' => payload['account_sid'],
-                  'age' => payload['age'].to_i,
+                  'age' => payload['age'] == nil ? payload['age'] : payload['age'].to_i,
                   'assignment_status' => payload['assignment_status'],
                   'attributes' => payload['attributes'],
                   'addons' => payload['addons'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'task_queue_entered_date' => Twilio.deserialize_iso8601_datetime(payload['task_queue_entered_date']),
-                  'priority' => payload['priority'].to_i,
+                  'priority' => payload['priority'] == nil ? payload['priority'] : payload['priority'].to_i,
                   'reason' => payload['reason'],
                   'sid' => payload['sid'],
                   'task_queue_sid' => payload['task_queue_sid'],
                   'task_queue_friendly_name' => payload['task_queue_friendly_name'],
                   'task_channel_sid' => payload['task_channel_sid'],
                   'task_channel_unique_name' => payload['task_channel_unique_name'],
-                  'timeout' => payload['timeout'].to_i,
+                  'timeout' => payload['timeout'] == nil ? payload['timeout'] : payload['timeout'].to_i,
                   'workflow_sid' => payload['workflow_sid'],
                   'workflow_friendly_name' => payload['workflow_friendly_name'],
                   'workspace_sid' => payload['workspace_sid'],
@@ -536,7 +552,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The amount of time in seconds that the Task is allowed to live
+            # @return [String] The amount of time in seconds that the Task can live before being assigned
             def timeout
               @properties['timeout']
             end
@@ -595,22 +611,33 @@ module Twilio
             # @param [String] task_channel When MultiTasking is enabled, specify the
             #   TaskChannel with the task to update. Can be the TaskChannel's SID or its
             #   `unique_name`, such as `voice`, `sms`, or `default`.
+            # @param [String] if_match If provided, applies this mutation if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [TaskInstance] Updated TaskInstance
-            def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset)
+            def update(attributes: :unset, assignment_status: :unset, reason: :unset, priority: :unset, task_channel: :unset, if_match: :unset)
               context.update(
                   attributes: attributes,
                   assignment_status: assignment_status,
                   reason: reason,
                   priority: priority,
                   task_channel: task_channel,
+                  if_match: if_match,
               )
             end
 
             ##
             # Delete the TaskInstance
+            # @param [String] if_match If provided, deletes this Task if (and only if) the
+            #   {ETag}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag] header of
+            #   the Task matches the provided value. This matches the semantics of (and is
+            #   implemented with) the HTTP {If-Match
+            #   header}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match].
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
+            def delete(if_match: :unset)
+              context.delete(if_match: if_match, )
             end
 
             ##

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/task_channel.rb

@@ -15,8 +15,8 @@ module Twilio
             ##
             # Initialize the TaskChannelList
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The SID of the Workspace that contains the
-            #   TaskChannel.
+            # @param [String] workspace_sid The SID of the Workspace that contains the Task
+            #   Channel.
             # @return [TaskChannelList] TaskChannelList
             def initialize(version, workspace_sid: nil)
               super(version)
@@ -109,10 +109,10 @@ module Twilio
             ##
             # Create the TaskChannelInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the TaskChannel. It can be up to 64 characters long.
+            #   the Task Channel. It can be up to 64 characters long.
             # @param [String] unique_name An application-defined string that uniquely
-            #   identifies the TaskChannel, such as `voice` or `sms`.
-            # @param [Boolean] channel_optimized_routing Whether the TaskChannel should
+            #   identifies the Task Channel, such as `voice` or `sms`.
+            # @param [Boolean] channel_optimized_routing Whether the Task Channel should
             #   prioritize Workers that have been idle. If `true`, Workers that have been idle
             #   the longest are prioritized.
             # @return [TaskChannelInstance] Created TaskChannelInstance
@@ -168,9 +168,9 @@ module Twilio
             ##
             # Initialize the TaskChannelContext
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The SID of the Workspace with the TaskChannel to
+            # @param [String] workspace_sid The SID of the Workspace with the Task Channel to
             #   fetch.
-            # @param [String] sid The SID of the TaskChannel resource to fetch.
+            # @param [String] sid The SID of the Task Channel resource to fetch.
             # @return [TaskChannelContext] TaskChannelContext
             def initialize(version, workspace_sid, sid)
               super(version)
@@ -197,7 +197,7 @@ module Twilio
             ##
             # Update the TaskChannelInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the TaskChannel. It can be up to 64 characters long.
+            #   the Task Channel. It can be up to 64 characters long.
             # @param [Boolean] channel_optimized_routing Whether the TaskChannel should
             #   prioritize Workers that have been idle. If `true`, Workers that have been idle
             #   the longest are prioritized.
@@ -245,9 +245,9 @@ module Twilio
             # Initialize the TaskChannelInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] workspace_sid The SID of the Workspace that contains the
-            #   TaskChannel.
-            # @param [String] sid The SID of the TaskChannel resource to fetch.
+            # @param [String] workspace_sid The SID of the Workspace that contains the Task
+            #   Channel.
+            # @param [String] sid The SID of the Task Channel resource to fetch.
             # @return [TaskChannelInstance] TaskChannelInstance
             def initialize(version, payload, workspace_sid: nil, sid: nil)
               super(version)
@@ -313,25 +313,25 @@ module Twilio
             end
 
             ##
-            # @return [String] An application-defined string that uniquely identifies the TaskChannel
+            # @return [String] An application-defined string that uniquely identifies the Task Channel
             def unique_name
               @properties['unique_name']
             end
 
             ##
-            # @return [String] The SID of the Workspace that contains the TaskChannel
+            # @return [String] The SID of the Workspace that contains the Task Channel
             def workspace_sid
               @properties['workspace_sid']
             end
 
             ##
-            # @return [Boolean] Whether the TaskChannel will prioritize Workers that have been idle
+            # @return [Boolean] Whether the Task Channel will prioritize Workers that have been idle
             def channel_optimized_routing
               @properties['channel_optimized_routing']
             end
 
             ##
-            # @return [String] The absolute URL of the TaskChannel resource
+            # @return [String] The absolute URL of the Task Channel resource
             def url
               @properties['url']
             end
@@ -352,7 +352,7 @@ module Twilio
             ##
             # Update the TaskChannelInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the TaskChannel. It can be up to 64 characters long.
+            #   the Task Channel. It can be up to 64 characters long.
             # @param [Boolean] channel_optimized_routing Whether the TaskChannel should
             #   prioritize Workers that have been idle. If `true`, Workers that have been idle
             #   the longest are prioritized.

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/task_queue/task_queue_cumulative_statistics.rb

@@ -89,19 +89,21 @@ module Twilio
               ##
               # Fetch the TaskQueueCumulativeStatisticsInstance
               # @param [Time] end_date Only calculate statistics from this date and time and
-              #   earlier, specified in GMT as an [ISO
-              #   8601](https://en.wikipedia.org/wiki/ISO_8601) date-time.
+              #   earlier, specified in GMT as an {ISO
+              #   8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time.
               # @param [String] minutes Only calculate statistics since this many minutes in the
               #   past. The default is 15 minutes.
               # @param [Time] start_date Only calculate statistics from this date and time and
-              #   later, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+              #   later, specified in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
               # @param [String] task_channel Only calculate cumulative statistics on this
               #   TaskChannel. Can be the TaskChannel's SID or its `unique_name`, such as `voice`,
               #   `sms`, or `default`.
               # @param [String] split_by_wait_time A comma separated list of values that
               #   describes the thresholds, in seconds, to calculate statistics on. For each
               #   threshold specified, the number of Tasks canceled and reservations accepted
-              #   above and below the specified thresholds in seconds are computed.
+              #   above and below the specified thresholds in seconds are computed. TaskRouter
+              #   will calculate statistics on up to 10,000 Tasks/Reservations for any given
+              #   threshold.
               # @return [TaskQueueCumulativeStatisticsInstance] Fetched TaskQueueCumulativeStatisticsInstance
               def fetch(end_date: :unset, minutes: :unset, start_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
                 params = Twilio::Values.of({
@@ -153,25 +155,25 @@ module Twilio
                 # Marshaled Properties
                 @properties = {
                     'account_sid' => payload['account_sid'],
-                    'avg_task_acceptance_time' => payload['avg_task_acceptance_time'].to_i,
+                    'avg_task_acceptance_time' => payload['avg_task_acceptance_time'] == nil ? payload['avg_task_acceptance_time'] : payload['avg_task_acceptance_time'].to_i,
                     'start_time' => Twilio.deserialize_iso8601_datetime(payload['start_time']),
                     'end_time' => Twilio.deserialize_iso8601_datetime(payload['end_time']),
-                    'reservations_created' => payload['reservations_created'].to_i,
-                    'reservations_accepted' => payload['reservations_accepted'].to_i,
-                    'reservations_rejected' => payload['reservations_rejected'].to_i,
-                    'reservations_timed_out' => payload['reservations_timed_out'].to_i,
-                    'reservations_canceled' => payload['reservations_canceled'].to_i,
-                    'reservations_rescinded' => payload['reservations_rescinded'].to_i,
+                    'reservations_created' => payload['reservations_created'] == nil ? payload['reservations_created'] : payload['reservations_created'].to_i,
+                    'reservations_accepted' => payload['reservations_accepted'] == nil ? payload['reservations_accepted'] : payload['reservations_accepted'].to_i,
+                    'reservations_rejected' => payload['reservations_rejected'] == nil ? payload['reservations_rejected'] : payload['reservations_rejected'].to_i,
+                    'reservations_timed_out' => payload['reservations_timed_out'] == nil ? payload['reservations_timed_out'] : payload['reservations_timed_out'].to_i,
+                    'reservations_canceled' => payload['reservations_canceled'] == nil ? payload['reservations_canceled'] : payload['reservations_canceled'].to_i,
+                    'reservations_rescinded' => payload['reservations_rescinded'] == nil ? payload['reservations_rescinded'] : payload['reservations_rescinded'].to_i,
                     'split_by_wait_time' => payload['split_by_wait_time'],
                     'task_queue_sid' => payload['task_queue_sid'],
                     'wait_duration_until_accepted' => payload['wait_duration_until_accepted'],
                     'wait_duration_until_canceled' => payload['wait_duration_until_canceled'],
                     'wait_duration_in_queue_until_accepted' => payload['wait_duration_in_queue_until_accepted'],
-                    'tasks_canceled' => payload['tasks_canceled'].to_i,
-                    'tasks_completed' => payload['tasks_completed'].to_i,
-                    'tasks_deleted' => payload['tasks_deleted'].to_i,
-                    'tasks_entered' => payload['tasks_entered'].to_i,
-                    'tasks_moved' => payload['tasks_moved'].to_i,
+                    'tasks_canceled' => payload['tasks_canceled'] == nil ? payload['tasks_canceled'] : payload['tasks_canceled'].to_i,
+                    'tasks_completed' => payload['tasks_completed'] == nil ? payload['tasks_completed'] : payload['tasks_completed'].to_i,
+                    'tasks_deleted' => payload['tasks_deleted'] == nil ? payload['tasks_deleted'] : payload['tasks_deleted'].to_i,
+                    'tasks_entered' => payload['tasks_entered'] == nil ? payload['tasks_entered'] : payload['tasks_entered'].to_i,
+                    'tasks_moved' => payload['tasks_moved'] == nil ? payload['tasks_moved'] : payload['tasks_moved'].to_i,
                     'workspace_sid' => payload['workspace_sid'],
                     'url' => payload['url'],
                 }
@@ -331,19 +333,21 @@ module Twilio
               ##
               # Fetch the TaskQueueCumulativeStatisticsInstance
               # @param [Time] end_date Only calculate statistics from this date and time and
-              #   earlier, specified in GMT as an [ISO
-              #   8601](https://en.wikipedia.org/wiki/ISO_8601) date-time.
+              #   earlier, specified in GMT as an {ISO
+              #   8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time.
               # @param [String] minutes Only calculate statistics since this many minutes in the
               #   past. The default is 15 minutes.
               # @param [Time] start_date Only calculate statistics from this date and time and
-              #   later, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+              #   later, specified in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] format.
               # @param [String] task_channel Only calculate cumulative statistics on this
               #   TaskChannel. Can be the TaskChannel's SID or its `unique_name`, such as `voice`,
               #   `sms`, or `default`.
               # @param [String] split_by_wait_time A comma separated list of values that
               #   describes the thresholds, in seconds, to calculate statistics on. For each
               #   threshold specified, the number of Tasks canceled and reservations accepted
-              #   above and below the specified thresholds in seconds are computed.
+              #   above and below the specified thresholds in seconds are computed. TaskRouter
+              #   will calculate statistics on up to 10,000 Tasks/Reservations for any given
+              #   threshold.
               # @return [TaskQueueCumulativeStatisticsInstance] Fetched TaskQueueCumulativeStatisticsInstance
               def fetch(end_date: :unset, minutes: :unset, start_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
                 context.fetch(