twilio-ruby 5.15.1 → 5.58.1

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,7 +15,7 @@ module Twilio
             ##
             # Initialize the WorkspaceRealTimeStatisticsList
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceRealTimeStatisticsList] WorkspaceRealTimeStatisticsList
             def initialize(version, workspace_sid: nil)
               super(version)
@@ -64,7 +64,7 @@ module Twilio
             ##
             # Initialize the WorkspaceRealTimeStatisticsContext
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace to fetch.
             # @return [WorkspaceRealTimeStatisticsContext] WorkspaceRealTimeStatisticsContext
             def initialize(version, workspace_sid)
               super(version)
@@ -75,19 +75,15 @@ module Twilio
             end
 
             ##
-            # Fetch a WorkspaceRealTimeStatisticsInstance
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
+            # Fetch the WorkspaceRealTimeStatisticsInstance
+            # @param [String] task_channel Only calculate real-time statistics on this
+            #   TaskChannel. Can be the TaskChannel's SID or its `unique_name`, such as `voice`,
+            #   `sms`, or `default`.
             # @return [WorkspaceRealTimeStatisticsInstance] Fetched WorkspaceRealTimeStatisticsInstance
             def fetch(task_channel: :unset)
               params = Twilio::Values.of({'TaskChannel' => task_channel, })
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri, params: params)
 
               WorkspaceRealTimeStatisticsInstance.new(@version, payload, workspace_sid: @solution[:workspace_sid], )
             end
@@ -98,6 +94,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Taskrouter.V1.WorkspaceRealTimeStatisticsContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Taskrouter.V1.WorkspaceRealTimeStatisticsContext #{context}>"
+            end
           end
 
           class WorkspaceRealTimeStatisticsInstance < InstanceResource
@@ -105,7 +108,7 @@ module Twilio
             # Initialize the WorkspaceRealTimeStatisticsInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceRealTimeStatisticsInstance] WorkspaceRealTimeStatisticsInstance
             def initialize(version, payload, workspace_sid: nil)
               super(version)
@@ -115,6 +118,7 @@ module Twilio
                   'account_sid' => payload['account_sid'],
                   'activity_statistics' => payload['activity_statistics'],
                   'longest_task_waiting_age' => payload['longest_task_waiting_age'].to_i,
+                  'longest_task_waiting_sid' => payload['longest_task_waiting_sid'],
                   'tasks_by_priority' => payload['tasks_by_priority'],
                   'tasks_by_status' => payload['tasks_by_status'],
                   'total_tasks' => payload['total_tasks'].to_i,
@@ -140,13 +144,13 @@ module Twilio
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [Hash] A breakdown of Workers by Activity
+            # @return [Array[Hash]] The number of current Workers by Activity
             def activity_statistics
               @properties['activity_statistics']
             end
@@ -158,13 +162,19 @@ module Twilio
             end
 
             ##
-            # @return [Hash] The tasks_by_priority
+            # @return [String] The SID of the longest waiting Task
+            def longest_task_waiting_sid
+              @properties['longest_task_waiting_sid']
+            end
+
+            ##
+            # @return [Hash] The number of Tasks by priority
             def tasks_by_priority
               @properties['tasks_by_priority']
             end
 
             ##
-            # @return [Hash] The Tasks broken down by status
+            # @return [Hash] The number of Tasks by their current status
             def tasks_by_status
               @properties['tasks_by_status']
             end
@@ -176,28 +186,28 @@ module Twilio
             end
 
             ##
-            # @return [String] The total number of Workers in the workspace
+            # @return [String] The total number of Workers in the Workspace
             def total_workers
               @properties['total_workers']
             end
 
             ##
-            # @return [String] The workspace_sid
+            # @return [String] The SID of the Workspace
             def workspace_sid
               @properties['workspace_sid']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the Workspace statistics resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a WorkspaceRealTimeStatisticsInstance
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
+            # Fetch the WorkspaceRealTimeStatisticsInstance
+            # @param [String] task_channel Only calculate real-time statistics on this
+            #   TaskChannel. Can be the TaskChannel's SID or its `unique_name`, such as `voice`,
+            #   `sms`, or `default`.
             # @return [WorkspaceRealTimeStatisticsInstance] Fetched WorkspaceRealTimeStatisticsInstance
             def fetch(task_channel: :unset)
               context.fetch(task_channel: task_channel, )

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,7 +15,7 @@ module Twilio
             ##
             # Initialize the WorkspaceStatisticsList
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceStatisticsList] WorkspaceStatisticsList
             def initialize(version, workspace_sid: nil)
               super(version)
@@ -64,7 +64,7 @@ module Twilio
             ##
             # Initialize the WorkspaceStatisticsContext
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace to fetch.
             # @return [WorkspaceStatisticsContext] WorkspaceStatisticsContext
             def initialize(version, workspace_sid)
               super(version)
@@ -75,24 +75,25 @@ module Twilio
             end
 
             ##
-            # Fetch a WorkspaceStatisticsInstance
-            # @param [String] minutes Filter cumulative statistics by up to 'x' minutes in the
-            #   past. This is helpful for statistics for the last 15 minutes, 240 minutes (4
-            #   hours), and 480 minutes (8 hours) to see trends. Defaults to 15 minutes.
-            # @param [Time] start_date Filter cumulative statistics by a start date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [Time] end_date Filter cumulative statistics by an end date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
-            # @param [String] split_by_wait_time A comma separated values for viewing splits
-            #   of tasks canceled and accepted above the given threshold in seconds. Ex: "5,30"
-            #   would show splits of tasks that were canceled or accepted before or after 5
-            #   seconds and respectively, 30 seconds. This is great for showing short abandoned
-            #   tasks or tasks that failed to meet your SLA.
+            # Fetch the WorkspaceStatisticsInstance
+            # @param [String] minutes Only calculate statistics since this many minutes in the
+            #   past. The default 15 minutes. This is helpful for displaying statistics for the
+            #   last 15 minutes, 240 minutes (4 hours), and 480 minutes (8 hours) to see trends.
+            # @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.
+            # @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.
+            # @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`.
+            # @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. For example,
+            #   `5,30` would show splits of Tasks that were canceled or accepted before and
+            #   after 5 seconds and before and after 30 seconds. This can be used to show short
+            #   abandoned Tasks or Tasks that failed to meet an SLA.
             # @return [WorkspaceStatisticsInstance] Fetched WorkspaceStatisticsInstance
             def fetch(minutes: :unset, start_date: :unset, end_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
               params = Twilio::Values.of({
@@ -103,11 +104,7 @@ module Twilio
                   'SplitByWaitTime' => split_by_wait_time,
               })
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri, params: params)
 
               WorkspaceStatisticsInstance.new(@version, payload, workspace_sid: @solution[:workspace_sid], )
             end
@@ -118,6 +115,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Taskrouter.V1.WorkspaceStatisticsContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Taskrouter.V1.WorkspaceStatisticsContext #{context}>"
+            end
           end
 
           class WorkspaceStatisticsInstance < InstanceResource
@@ -125,7 +129,7 @@ module Twilio
             # Initialize the WorkspaceStatisticsInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceStatisticsInstance] WorkspaceStatisticsInstance
             def initialize(version, payload, workspace_sid: nil)
               super(version)
@@ -156,54 +160,55 @@ module Twilio
             end
 
             ##
-            # @return [Hash] The realtime
+            # @return [Hash] n object that contains the real-time statistics for the Workspace
             def realtime
               @properties['realtime']
             end
 
             ##
-            # @return [Hash] The cumulative
+            # @return [Hash] An object that contains the cumulative statistics for the Workspace
             def cumulative
               @properties['cumulative']
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The workspace_sid
+            # @return [String] The SID of the Workspace
             def workspace_sid
               @properties['workspace_sid']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the Workspace statistics resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a WorkspaceStatisticsInstance
-            # @param [String] minutes Filter cumulative statistics by up to 'x' minutes in the
-            #   past. This is helpful for statistics for the last 15 minutes, 240 minutes (4
-            #   hours), and 480 minutes (8 hours) to see trends. Defaults to 15 minutes.
-            # @param [Time] start_date Filter cumulative statistics by a start date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [Time] end_date Filter cumulative statistics by an end date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
-            # @param [String] split_by_wait_time A comma separated values for viewing splits
-            #   of tasks canceled and accepted above the given threshold in seconds. Ex: "5,30"
-            #   would show splits of tasks that were canceled or accepted before or after 5
-            #   seconds and respectively, 30 seconds. This is great for showing short abandoned
-            #   tasks or tasks that failed to meet your SLA.
+            # Fetch the WorkspaceStatisticsInstance
+            # @param [String] minutes Only calculate statistics since this many minutes in the
+            #   past. The default 15 minutes. This is helpful for displaying statistics for the
+            #   last 15 minutes, 240 minutes (4 hours), and 480 minutes (8 hours) to see trends.
+            # @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.
+            # @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.
+            # @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`.
+            # @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. For example,
+            #   `5,30` would show splits of Tasks that were canceled or accepted before and
+            #   after 5 seconds and before and after 30 seconds. This can be used to show short
+            #   abandoned Tasks or Tasks that failed to meet an SLA.
             # @return [WorkspaceStatisticsInstance] Fetched WorkspaceStatisticsInstance
             def fetch(minutes: :unset, start_date: :unset, end_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
               context.fetch(

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -27,9 +27,8 @@ module Twilio
           # Lists WorkspaceInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] friendly_name Filter by a workspace's friendly name. This is a
-          #   human readable description of this Workspace (for example "Customer Support" or
-          #   "2014 Election Campaign")
+          # @param [String] friendly_name The `friendly_name` of the Workspace resources to
+          #   read. For example `Customer Support` or `2014 Election Campaign`.
           # @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
@@ -45,9 +44,8 @@ module Twilio
           # Streams WorkspaceInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] friendly_name Filter by a workspace's friendly name. This is a
-          #   human readable description of this Workspace (for example "Customer Support" or
-          #   "2014 Election Campaign")
+          # @param [String] friendly_name The `friendly_name` of the Workspace resources to
+          #   read. For example `Customer Support` or `2014 Election Campaign`.
           # @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
@@ -80,9 +78,8 @@ module Twilio
           ##
           # Retrieve a single page of WorkspaceInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name Filter by a workspace's friendly name. This is a
-          #   human readable description of this Workspace (for example "Customer Support" or
-          #   "2014 Election Campaign")
+          # @param [String] friendly_name The `friendly_name` of the Workspace resources to
+          #   read. For example `Customer Support` or `2014 Election Campaign`.
           # @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
@@ -94,11 +91,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             WorkspacePage.new(@version, response, @solution)
           end
 
@@ -116,36 +111,36 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of WorkspaceInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] friendly_name Human readable description of this workspace (for
-          #   example "Customer Support" or "2014 Election Campaign")
-          # @param [String] event_callback_url If provided, the Workspace will publish
-          #   events to this URL. You can use this to gather data for reporting. See Workspace
-          #   Events for more information.
-          # @param [String] events_filter Use this parameter to receive webhooks on
-          #   EventCallbackUrl for specific events on a workspace. For example if
-          #   'EventsFilter=task.created,task.canceled,worker.activity.update', then
-          #   TaskRouter will webhook to EventCallbackUrl only when a task is created,
-          #   canceled or a worker activity is updated.
-          # @param [Boolean] multi_task_enabled Multi tasking allows workers to handle
-          #   multiple tasks simultaneously. When enabled (MultiTaskEnabled=true), each worker
-          #   will be eligible to receive parallel reservations up to the per-channel maximums
-          #   defined in the Workers section. Default is disabled (MultiTaskEnabled=false),
-          #   where each worker will only receive a new reservation when the previous task is
-          #   completed. Learn more by visiting [Multitasking][/docs/taskrouter/multitasking].
-          # @param [String] template One of the available template names. Will pre-configure
-          #   this Workspace with the Workflow and Activities specified in the template.
-          #   "NONE" will create a Workspace with a set of default activities and nothing
-          #   else. "FIFO" will configure TaskRouter with a set of default activities and a
-          #   single task queue for first-in, first-out distribution, useful if you want to
-          #   see a simple TaskRouter configuration when getting started. Defaults to "NONE".
-          # @param [workspace.QueueOrder] prioritize_queue_order Use this parameter to
-          #   configure whether to prioritize LIFO or FIFO when workers are receiving Tasks
-          #   from combination of LIFO and FIFO TaskQueues. Default is FIFO. [Click
-          #   here][/docs/taskrouter/queue-ordering-last-first-out-lifo] to learn more about
-          #   LIFO and the use of the parameter.
-          # @return [WorkspaceInstance] Newly created WorkspaceInstance
+          # Create the WorkspaceInstance
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Workspace resource. It can be up to 64 characters long. For example:
+          #   `Customer Support` or `2014 Election Campaign`.
+          # @param [String] event_callback_url The URL we should call when an event occurs.
+          #   If provided, the Workspace will publish events to this URL, for example, to
+          #   collect data for reporting. See {Workspace
+          #   Events}[https://www.twilio.com/docs/taskrouter/api/event] for more information.
+          # @param [String] events_filter The list of Workspace events for which to call
+          #   event_callback_url. For example, if `EventsFilter=task.created, task.canceled,
+          #   worker.activity.update`, then TaskRouter will call event_callback_url only when
+          #   a task is created, canceled, or a Worker activity is updated.
+          # @param [Boolean] multi_task_enabled Whether to enable multi-tasking. Can be:
+          #   `true` to enable multi-tasking, or `false` to disable it. The default is
+          #   `false`. Multi-tasking allows Workers to handle multiple Tasks simultaneously.
+          #   When enabled (`true`), each Worker can receive parallel reservations up to the
+          #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
+          #   only receive a new reservation when the previous task is completed. Learn more
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
+          # @param [String] template An available template name. Can be: `NONE` or `FIFO`
+          #   and the default is `NONE`. Pre-configures the Workspace with the Workflow and
+          #   Activities specified in the template. `NONE` will create a Workspace with only a
+          #   set of default activities. `FIFO` will configure TaskRouter with a set of
+          #   default activities and a single TaskQueue for first-in, first-out distribution,
+          #   which can be useful when you are getting started with TaskRouter.
+          # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
+          #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
+          # @return [WorkspaceInstance] Created WorkspaceInstance
           def create(friendly_name: nil, event_callback_url: :unset, events_filter: :unset, multi_task_enabled: :unset, template: :unset, prioritize_queue_order: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -156,11 +151,7 @@ module Twilio
                 'PrioritizeQueueOrder' => prioritize_queue_order,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             WorkspaceInstance.new(@version, payload, )
           end
@@ -205,7 +196,7 @@ module Twilio
           ##
           # Initialize the WorkspaceContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the Workspace resource to fetch.
           # @return [WorkspaceContext] WorkspaceContext
           def initialize(version, sid)
             super(version)
@@ -228,44 +219,42 @@ module Twilio
           end
 
           ##
-          # Fetch a WorkspaceInstance
+          # Fetch the WorkspaceInstance
           # @return [WorkspaceInstance] Fetched WorkspaceInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             WorkspaceInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the WorkspaceInstance
-          # @param [String] default_activity_sid The ID of the Activity that will be used
-          #   when new Workers are created in this Workspace.
-          # @param [String] event_callback_url The Workspace will publish events to this
-          #   URL. You can use this to gather data for reporting. See
-          #   [Events][/docs/taskrouter/api/events] for more information.
-          # @param [String] events_filter Use this parameter to receive webhooks on
-          #   EventCallbackUrl for specific events on a workspace. For example if
-          #   'EventsFilter=task.created,task.canceled,worker.activity.update', then
-          #   TaskRouter will webhook to EventCallbackUrl only when a task is created,
-          #   canceled or a worker activity is updated.
-          # @param [String] friendly_name Human readable description of this workspace (for
-          #   example "Sales Call Center" or "Customer Support Team")
-          # @param [Boolean] multi_task_enabled Enable or Disable Multitasking by passing
-          #   either *true* or *False* with the POST request. Learn more by visiting
-          #   [Multitasking][/docs/taskrouter/multitasking].
-          # @param [String] timeout_activity_sid The ID of the Activity that will be
+          # @param [String] default_activity_sid The SID of the Activity that will be used
+          #   when new Workers are created in the Workspace.
+          # @param [String] event_callback_url The URL we should call when an event occurs.
+          #   See {Workspace Events}[https://www.twilio.com/docs/taskrouter/api/event] for
+          #   more information.
+          # @param [String] events_filter The list of Workspace events for which to call
+          #   event_callback_url. For example if
+          #   `EventsFilter=task.created,task.canceled,worker.activity.update`, then
+          #   TaskRouter will call event_callback_url only when a task is created, canceled,
+          #   or a Worker activity is updated.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Workspace resource. For example: `Sales Call Center` or `Customer Support
+          #   Team`.
+          # @param [Boolean] multi_task_enabled Whether to enable multi-tasking. Can be:
+          #   `true` to enable multi-tasking, or `false` to disable it. The default is
+          #   `false`. Multi-tasking allows Workers to handle multiple Tasks simultaneously.
+          #   When enabled (`true`), each Worker can receive parallel reservations up to the
+          #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
+          #   only receive a new reservation when the previous task is completed. Learn more
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
+          # @param [String] timeout_activity_sid The SID of the Activity that will be
           #   assigned to a Worker when a Task reservation times out without a response.
-          # @param [workspace.QueueOrder] prioritize_queue_order Use this parameter to
-          #   configure whether to prioritize LIFO or FIFO when workers are receiving Tasks
-          #   from combination of LIFO and FIFO TaskQueues. Default is FIFO. [Click
-          #   here][/docs/taskrouter/queue-ordering-last-first-out-lifo] to learn more about
-          #   LIFO and the use of the parameter.
+          # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
+          #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
           # @return [WorkspaceInstance] Updated WorkspaceInstance
           def update(default_activity_sid: :unset, event_callback_url: :unset, events_filter: :unset, friendly_name: :unset, multi_task_enabled: :unset, timeout_activity_sid: :unset, prioritize_queue_order: :unset)
             data = Twilio::Values.of({
@@ -278,20 +267,16 @@ module Twilio
                 'PrioritizeQueueOrder' => prioritize_queue_order,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             WorkspaceInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the WorkspaceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the WorkspaceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -450,6 +435,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Taskrouter.V1.WorkspaceContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Taskrouter.V1.WorkspaceContext #{context}>"
+          end
         end
 
         class WorkspaceInstance < InstanceResource
@@ -457,7 +449,7 @@ module Twilio
           # Initialize the WorkspaceInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the Workspace resource to fetch.
           # @return [WorkspaceInstance] WorkspaceInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -498,97 +490,97 @@ module Twilio
           end
 
           ##
-          # @return [String] The ID of the account that owns this Workflow
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [Time] The time the Workspace was created, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The time the Workspace was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The human readable name of the default activity.
+          # @return [String] The name of the default activity
           def default_activity_name
             @properties['default_activity_name']
           end
 
           ##
-          # @return [String] The ID of the Activity that will be used when new Workers are created in this Workspace.
+          # @return [String] The SID of the Activity that will be used when new Workers are created in the Workspace
           def default_activity_sid
             @properties['default_activity_sid']
           end
 
           ##
-          # @return [String] If provided, the Workspace will publish events to this URL.
+          # @return [String] The URL we call when an event occurs
           def event_callback_url
             @properties['event_callback_url']
           end
 
           ##
-          # @return [String] Use this parameter to receive webhooks on EventCallbackUrl for specific events on a workspace.
+          # @return [String] The list of Workspace events for which to call event_callback_url
           def events_filter
             @properties['events_filter']
           end
 
           ##
-          # @return [String] Filter by a workspace's friendly name.
+          # @return [String] The string that you assigned to describe the Workspace resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [Boolean] Multi tasking allows workers to handle multiple tasks simultaneously.
+          # @return [Boolean] Whether multi-tasking is enabled
           def multi_task_enabled
             @properties['multi_task_enabled']
           end
 
           ##
-          # @return [String] The unique ID of the Workspace
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The human readable name of the timeout activity.
+          # @return [String] The name of the timeout activity
           def timeout_activity_name
             @properties['timeout_activity_name']
           end
 
           ##
-          # @return [String] The ID of the Activity that will be assigned to a Worker when a Task reservation times out without a response.
+          # @return [String] The SID of the Activity that will be assigned to a Worker when a Task reservation times out without a response
           def timeout_activity_sid
             @properties['timeout_activity_sid']
           end
 
           ##
-          # @return [workspace.QueueOrder] Use this parameter to configure whether to prioritize LIFO or FIFO when workers are receiving Tasks from combination of LIFO and FIFO TaskQueues.
+          # @return [workspace.QueueOrder] The type of TaskQueue to prioritize when Workers are receiving Tasks from both types of TaskQueues
           def prioritize_queue_order
             @properties['prioritize_queue_order']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the Workspace resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] The URLs of related resources
           def links
             @properties['links']
           end
 
           ##
-          # Fetch a WorkspaceInstance
+          # Fetch the WorkspaceInstance
           # @return [WorkspaceInstance] Fetched WorkspaceInstance
           def fetch
             context.fetch
@@ -596,28 +588,32 @@ module Twilio
 
           ##
           # Update the WorkspaceInstance
-          # @param [String] default_activity_sid The ID of the Activity that will be used
-          #   when new Workers are created in this Workspace.
-          # @param [String] event_callback_url The Workspace will publish events to this
-          #   URL. You can use this to gather data for reporting. See
-          #   [Events][/docs/taskrouter/api/events] for more information.
-          # @param [String] events_filter Use this parameter to receive webhooks on
-          #   EventCallbackUrl for specific events on a workspace. For example if
-          #   'EventsFilter=task.created,task.canceled,worker.activity.update', then
-          #   TaskRouter will webhook to EventCallbackUrl only when a task is created,
-          #   canceled or a worker activity is updated.
-          # @param [String] friendly_name Human readable description of this workspace (for
-          #   example "Sales Call Center" or "Customer Support Team")
-          # @param [Boolean] multi_task_enabled Enable or Disable Multitasking by passing
-          #   either *true* or *False* with the POST request. Learn more by visiting
-          #   [Multitasking][/docs/taskrouter/multitasking].
-          # @param [String] timeout_activity_sid The ID of the Activity that will be
+          # @param [String] default_activity_sid The SID of the Activity that will be used
+          #   when new Workers are created in the Workspace.
+          # @param [String] event_callback_url The URL we should call when an event occurs.
+          #   See {Workspace Events}[https://www.twilio.com/docs/taskrouter/api/event] for
+          #   more information.
+          # @param [String] events_filter The list of Workspace events for which to call
+          #   event_callback_url. For example if
+          #   `EventsFilter=task.created,task.canceled,worker.activity.update`, then
+          #   TaskRouter will call event_callback_url only when a task is created, canceled,
+          #   or a Worker activity is updated.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Workspace resource. For example: `Sales Call Center` or `Customer Support
+          #   Team`.
+          # @param [Boolean] multi_task_enabled Whether to enable multi-tasking. Can be:
+          #   `true` to enable multi-tasking, or `false` to disable it. The default is
+          #   `false`. Multi-tasking allows Workers to handle multiple Tasks simultaneously.
+          #   When enabled (`true`), each Worker can receive parallel reservations up to the
+          #   per-channel maximums defined in the Workers section. Otherwise, each Worker will
+          #   only receive a new reservation when the previous task is completed. Learn more
+          #   at {Multitasking}[https://www.twilio.com/docs/taskrouter/multitasking].
+          # @param [String] timeout_activity_sid The SID of the Activity that will be
           #   assigned to a Worker when a Task reservation times out without a response.
-          # @param [workspace.QueueOrder] prioritize_queue_order Use this parameter to
-          #   configure whether to prioritize LIFO or FIFO when workers are receiving Tasks
-          #   from combination of LIFO and FIFO TaskQueues. Default is FIFO. [Click
-          #   here][/docs/taskrouter/queue-ordering-last-first-out-lifo] to learn more about
-          #   LIFO and the use of the parameter.
+          # @param [workspace.QueueOrder] prioritize_queue_order The type of TaskQueue to
+          #   prioritize when Workers are receiving Tasks from both types of TaskQueues. Can
+          #   be: `LIFO` or `FIFO` and the default is `FIFO`. For more information, see {Queue
+          #   Ordering}[https://www.twilio.com/docs/taskrouter/queue-ordering-last-first-out-lifo].
           # @return [WorkspaceInstance] Updated WorkspaceInstance
           def update(default_activity_sid: :unset, event_callback_url: :unset, events_filter: :unset, friendly_name: :unset, multi_task_enabled: :unset, timeout_activity_sid: :unset, prioritize_queue_order: :unset)
             context.update(
@@ -632,8 +628,8 @@ module Twilio
           end
 
           ##
-          # Deletes the WorkspaceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the WorkspaceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end