twilio-ruby 5.31.0 → 5.46.0

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

@@ -87,14 +87,14 @@ module Twilio
               end
 
               ##
-              # Fetch a TaskQueueStatisticsInstance
+              # Fetch the TaskQueueStatisticsInstance
               # @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 real-time and cumulative statistics
               #   for the specified TaskChannel. Can be the TaskChannel's SID or its
               #   `unique_name`, such as `voice`, `sms`, or `default`.
@@ -112,11 +112,7 @@ module Twilio
                     'SplitByWaitTime' => split_by_wait_time,
                 })
 
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri, params: params)
 
                 TaskQueueStatisticsInstance.new(
                     @version,
@@ -221,14 +217,14 @@ module Twilio
               end
 
               ##
-              # Fetch a TaskQueueStatisticsInstance
+              # Fetch the TaskQueueStatisticsInstance
               # @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 real-time and cumulative statistics
               #   for the specified TaskChannel. Can be the TaskChannel's SID or its
               #   `unique_name`, such as `voice`, `sms`, or `default`.

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

@@ -32,14 +32,14 @@ module Twilio
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
               # @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] friendly_name The `friendly_name` of the TaskQueue statistics to
               #   read.
               # @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 statistics on this TaskChannel. Can
               #   be the TaskChannel's SID or its `unique_name`, such as `voice`, `sms`, or
               #   `default`.
@@ -72,14 +72,14 @@ module Twilio
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
               # @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] friendly_name The `friendly_name` of the TaskQueue statistics to
               #   read.
               # @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 statistics on this TaskChannel. Can
               #   be the TaskChannel's SID or its `unique_name`, such as `voice`, `sms`, or
               #   `default`.
@@ -128,14 +128,14 @@ module Twilio
               # Retrieve a single page of TaskQueuesStatisticsInstance records from the API.
               # Request is executed immediately.
               # @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] friendly_name The `friendly_name` of the TaskQueue statistics to
               #   read.
               # @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 statistics on this TaskChannel. Can
               #   be the TaskChannel's SID or its `unique_name`, such as `voice`, `sms`, or
               #   `default`.
@@ -159,11 +159,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 TaskQueuesStatisticsPage.new(@version, response, @solution)
               end
 

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

@@ -163,11 +163,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               WorkerPage.new(@version, response, @solution)
             end
 
@@ -185,20 +183,19 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of WorkerInstance records from the API.
-            # Request is executed immediately.
+            # Create the WorkerInstance
             # @param [String] friendly_name A descriptive string that you create to describe
             #   the new Worker. It can be up to 64 characters long.
             # @param [String] activity_sid The SID of a valid Activity that will describe the
             #   new Worker's initial state. See
-            #   [Activities](https://www.twilio.com/docs/taskrouter/api/activity) for more
+            #   {Activities}[https://www.twilio.com/docs/taskrouter/api/activity] for more
             #   information. If not provided, the new Worker's initial state is the
             #   `default_activity_sid` configured on the Workspace.
             # @param [String] attributes A valid JSON string that describes the new Worker.
             #   For example: `{ "email": "Bob@example.com", "phone": "+5095551234" }`. This data
             #   is passed to the `assignment_callback_url` when TaskRouter assigns a Task to the
             #   Worker. Defaults to {}.
-            # @return [WorkerInstance] Newly created WorkerInstance
+            # @return [WorkerInstance] Created WorkerInstance
             def create(friendly_name: nil, activity_sid: :unset, attributes: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
@@ -206,23 +203,16 @@ module Twilio
                   'Attributes' => attributes,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               WorkerInstance.new(@version, payload, workspace_sid: @solution[:workspace_sid], )
             end
 
             ##
             # Access the statistics
-            # @return [WorkersStatisticsList]
-            # @return [WorkersStatisticsContext]
+            # @return [WorkersStatisticsContext] WorkersStatisticsContext
             def statistics
               return WorkersStatisticsContext.new(@version, @solution[:workspace_sid], )
-
-              @statistics ||= WorkersStatisticsList.new(@version, workspace_sid: @solution[:workspace_sid], )
             end
 
             ##
@@ -284,16 +274,10 @@ module Twilio
             end
 
             ##
-            # Fetch a WorkerInstance
+            # Fetch the WorkerInstance
             # @return [WorkerInstance] Fetched WorkerInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               WorkerInstance.new(
                   @version,
@@ -307,7 +291,7 @@ module Twilio
             # Update the WorkerInstance
             # @param [String] activity_sid The SID of a valid Activity that will describe the
             #   Worker's initial state. See
-            #   [Activities](https://www.twilio.com/docs/taskrouter/api/activity) for more
+            #   {Activities}[https://www.twilio.com/docs/taskrouter/api/activity] for more
             #   information.
             # @param [String] attributes The JSON string that describes the Worker. For
             #   example: `{ "email": "Bob@example.com", "phone": "+5095551234" }`. This data is
@@ -326,11 +310,7 @@ module Twilio
                   'RejectPendingReservations' => reject_pending_reservations,
               })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               WorkerInstance.new(
                   @version,
@@ -341,10 +321,10 @@ module Twilio
             end
 
             ##
-            # Deletes the WorkerInstance
+            # Delete the WorkerInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -553,7 +533,7 @@ module Twilio
             end
 
             ##
-            # Fetch a WorkerInstance
+            # Fetch the WorkerInstance
             # @return [WorkerInstance] Fetched WorkerInstance
             def fetch
               context.fetch
@@ -563,7 +543,7 @@ module Twilio
             # Update the WorkerInstance
             # @param [String] activity_sid The SID of a valid Activity that will describe the
             #   Worker's initial state. See
-            #   [Activities](https://www.twilio.com/docs/taskrouter/api/activity) for more
+            #   {Activities}[https://www.twilio.com/docs/taskrouter/api/activity] for more
             #   information.
             # @param [String] attributes The JSON string that describes the Worker. For
             #   example: `{ "email": "Bob@example.com", "phone": "+5095551234" }`. This data is
@@ -584,7 +564,7 @@ module Twilio
             end
 
             ##
-            # Deletes the WorkerInstance
+            # Delete the WorkerInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

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

@@ -99,11 +99,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 ReservationPage.new(@version, response, @solution)
               end
 
@@ -180,16 +178,10 @@ module Twilio
               end
 
               ##
-              # Fetch a ReservationInstance
+              # Fetch the ReservationInstance
               # @return [ReservationInstance] Fetched ReservationInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 ReservationInstance.new(
                     @version,
@@ -218,7 +210,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.
@@ -230,7 +222,7 @@ module Twilio
               #   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.
@@ -246,7 +238,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.
@@ -254,8 +246,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 The timeout for a call when executing a Conference
               #   instruction.
@@ -276,8 +268,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.
@@ -294,7 +286,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
@@ -317,11 +309,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) where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, or `jp1`.
+              #   {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 [Boolean] end_conference_on_customer_exit Whether to end the conference
@@ -384,11 +378,7 @@ module Twilio
                     'BeepOnCustomerEntrance' => beep_on_customer_entrance,
                 })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 ReservationInstance.new(
                     @version,
@@ -534,7 +524,7 @@ module Twilio
               end
 
               ##
-              # Fetch a ReservationInstance
+              # Fetch the ReservationInstance
               # @return [ReservationInstance] Fetched ReservationInstance
               def fetch
                 context.fetch
@@ -558,7 +548,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.
@@ -570,7 +560,7 @@ module Twilio
               #   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.
@@ -586,7 +576,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.
@@ -594,8 +584,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 The timeout for a call when executing a Conference
               #   instruction.
@@ -616,8 +606,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.
@@ -634,7 +624,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
@@ -657,11 +647,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) where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, or `jp1`.
+              #   {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 [Boolean] end_conference_on_customer_exit Whether to end the conference