twilio-ruby 5.0.0.rc13 → 5.0.0.rc14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eab37c2de7a77e03a9e4be48c1cd86a1f032e55a
-  data.tar.gz: e594dc3a3f60a0b537ee05a8361a7dbc0a6b8d3f
+  metadata.gz: 9211a021f399ed356530eff15db5a4bf4f413767
+  data.tar.gz: 875e85e3705723ac5639ed8b171f2bee92b1432b
 SHA512:
-  metadata.gz: a754b90efe265656302efd55da3b41b35edcd855fbc24e6a4ac0650638ee5083b0903589bd6864dddb42872b53d2f1803c6706a3f42e804b5e819e328d69def3
-  data.tar.gz: f2829389df7b7d61a46b13c37349d79a3b56425e0bdbf075bd2e72d2ce8423c8bfd735304e4f72f7a6571b59d665a181b5ab380aeaa3aa8edde0d0085c468c6d
+  metadata.gz: 85baeb0d8ec8d4fe6ce0e828055615a4772998145a0fde5608d9f412f2e7330223315aeedad491f8247be15100bc9c67f6976aaad1f18932b31db81324d1302e
+  data.tar.gz: e7857cd7165efd56bdf6b436292d8ed94f4fdf84c885f59df9ea312ff2febd08fbdf470a0d2306169d5090780b5f605ad6f25c3e7b00472e48a540923c352683

data/README.md

@@ -11,13 +11,13 @@ A module for using the Twilio REST API and generating valid [TwiML](http://www.t
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.0.0.rc13'
+gem 'twilio-ruby', '~> 5.0.0.rc14'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.0.0.rc13
+gem install twilio-ruby -v 5.0.0.rc14
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/framework/exception.rb

@@ -1,13 +1,29 @@
 module Twilio
   module REST
     class TwilioException < Exception
-      def initialize(msg, body = nil)
-        @msg = msg
+      attr_reader :message, :body
+
+      def initialize(message, body = nil)
+        @message = message
         @body = body
       end
 
       def to_s
-        "#{@msg}: #{@body || 'no body'}"
+        "#{@message}: #{@body || 'no body'}"
+      end
+    end
+
+    class RestException < TwilioException
+      attr_reader :message, :code, :status_code
+
+      def initialize(message, code, status_code)
+        @message = message
+        @code = code
+        @status_code = status_code
+      end
+
+      def to_s
+        "[HTTP #{status_code}] #{code} : #{msg}"
       end
     end
   end

data/lib/twilio-ruby/framework/version.rb

@@ -62,6 +62,21 @@ module Twilio
         )
       end
 
+      def exception(response, header)
+        message = header
+        code = response.status_code
+
+        if response.body.has_key?('message')
+          message += ": #{response.body['message']}"
+        end
+
+        if response.body.has_key?('code')
+          code = response.body['code']
+        end
+
+        return Twilio::REST::RestException.new(message, code, response.status_code)
+      end
+
       def fetch(method, uri, params={}, data={}, headers={}, auth=nil, timeout=nil)
         response = self.request(
           method,
@@ -74,7 +89,7 @@ module Twilio
         )
 
         if response.status_code < 200 || response.status_code >= 300
-          raise Twilio::REST::TwilioException.new('Unable to fetch record')
+          raise exception(response, 'Unable to fetch record')
         end
 
         response.body
@@ -92,7 +107,7 @@ module Twilio
         )
 
         if response.status_code < 200 || response.status_code >= 300
-          raise TwilioException.new('Unable to update record')
+          raise exception(response, 'Unable to update record')
         end
 
         response.body
@@ -110,7 +125,7 @@ module Twilio
         )
 
         if response.status_code < 200 || response.status_code >= 300
-          raise TwilioException.new('Unable to delete record')
+          raise exception(response, 'Unable to delete record')
         end
 
         response.status_code == 204
@@ -159,10 +174,10 @@ module Twilio
                     timeout)
 
         if response.status_code < 200 || response.status_code >= 300
-          raise TwilioException.new("[#{response.status_code}] Unable to create record\n#{response.body}")
+          raise exception(response, 'Unable to create record')
         end
 
-        return response.body
+        response.body
       end
     end
   end

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

@@ -48,6 +48,7 @@ module Twilio
             # @param [String] status_callback A URL that Twilio will request when the call
             #   ends to notify your app. If an `ApplicationSid` was provided, this parameter is
             #   ignored.
+            # @param [String] status_callback_event The status_callback_event
             # @param [String] status_callback_method The HTTP method that Twilio should use to
             #   request the `StatusCallback`. Defaults to `POST`. If an `ApplicationSid` was
             #   provided, this parameter is ignored.
@@ -66,6 +67,10 @@ module Twilio
             # @param [Boolean] record Set this parameter to true to record the entirety of a
             #   phone call. The RecordingUrl will be sent to the StatusCallback URL. Defaults to
             #   false.
+            # @param [String] recording_channels The recording_channels
+            # @param [String] recording_status_callback The recording_status_callback
+            # @param [String] recording_status_callback_method The
+            #   recording_status_callback_method
             # @param [String] sip_auth_username The sip_auth_username
             # @param [String] sip_auth_password The sip_auth_password
             # @param [String] url The fully qualified URL that should be consulted when the
@@ -75,7 +80,7 @@ module Twilio
             #   should use to handle this phone call. If this parameter is present, Twilio will
             #   ignore all of the voice URLs passed and use the URLs set on the application.
             # @return [CallInstance] Newly created CallInstance
-            def create(to: nil, from: nil, method: nil, fallback_url: nil, fallback_method: nil, status_callback: nil, status_callback_method: nil, send_digits: nil, if_machine: nil, timeout: nil, record: nil, sip_auth_username: nil, sip_auth_password: nil, url: nil, application_sid: nil)
+            def create(to: nil, from: nil, method: nil, fallback_url: nil, fallback_method: nil, status_callback: nil, status_callback_event: nil, status_callback_method: nil, send_digits: nil, if_machine: nil, timeout: nil, record: nil, recording_channels: nil, recording_status_callback: nil, recording_status_callback_method: nil, sip_auth_username: nil, sip_auth_password: nil, url: nil, application_sid: nil)
               data = {
                   'To' => to,
                   'From' => from,
@@ -85,11 +90,15 @@ module Twilio
                   'FallbackUrl' => fallback_url,
                   'FallbackMethod' => fallback_method,
                   'StatusCallback' => status_callback,
+                  'StatusCallbackEvent' => status_callback_event,
                   'StatusCallbackMethod' => status_callback_method,
                   'SendDigits' => send_digits,
                   'IfMachine' => if_machine,
                   'Timeout' => timeout,
                   'Record' => record,
+                  'RecordingChannels' => recording_channels,
+                  'RecordingStatusCallback' => recording_status_callback,
+                  'RecordingStatusCallbackMethod' => recording_status_callback_method,
                   'SipAuthUsername' => sip_auth_username,
                   'SipAuthPassword' => sip_auth_password,
               }

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

@@ -9,14 +9,16 @@ module Twilio
     ##
     # A client for accessing the Twilio API.
     class Client
-      attr_accessor :http_client, :account_sid, :auth_token
+      attr_accessor :http_client, :username, :password, :account_sid, :auth_token
       
       ##
       # Initializes the Twilio Client
-      def initialize(account_sid, auth_token, http_client=Twilio::HTTP::Client.new)
-        @account_sid = account_sid
-        @auth_token = auth_token
-        @auth = [@account_sid, @auth_token]
+      def initialize(username=nil, password=nil, account_sid=nil, http_client=Twilio::HTTP::Client.new)
+        @username = username || Twilio.configuration.account_sid
+        @password = password || Twilio.configuration.auth_token
+        @account_sid = account_sid || @username
+        @auth_token = @password
+        @auth = [@username, @password]
         @http_client = http_client
         
         # Domains

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

@@ -32,9 +32,7 @@ module Twilio
               # Lists ReservationInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [String] status The status
-              # @param [String] assignment_status The assignment_status
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @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 not set will                      use
@@ -42,10 +40,8 @@ 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(status: nil, assignment_status: nil, reservation_status: nil, limit: nil, page_size: nil)
+              def list(reservation_status: nil, limit: nil, page_size: nil)
                 self.stream(
-                    status: status,
-                    assignment_status: assignment_status,
                     reservation_status: reservation_status,
                     limit: limit,
                     page_size: page_size
@@ -56,9 +52,7 @@ module Twilio
               # Streams ReservationInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [String] status The status
-              # @param [String] assignment_status The assignment_status
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @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                      not set will use
@@ -66,12 +60,10 @@ module Twilio
               #                       but a limit is defined, stream() will attempt to                      read the
               #  limit with the most efficient page size,                       i.e. min(limit, 1000)
               # @return [Enumerable] Enumerable that will yield up to limit results
-              def stream(status: nil, assignment_status: nil, reservation_status: nil, limit: nil, page_size: nil)
+              def stream(reservation_status: nil, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
                 
                 page = self.page(
-                    status: status,
-                    assignment_status: assignment_status,
                     reservation_status: reservation_status,
                     page_size: limits[:page_size],
                 )
@@ -83,9 +75,7 @@ module Twilio
               # When passed a block, yields ReservationInstance records from the API.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [String] status The status
-              # @param [String] assignment_status The assignment_status
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @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                       not set will use
@@ -107,17 +97,13 @@ module Twilio
               ##
               # Retrieve a single page of ReservationInstance records from the API.
               # Request is executed immediately.
-              # @param [String] status The status
-              # @param [String] assignment_status The assignment_status
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @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(status: nil, assignment_status: nil, reservation_status: nil, page_token: nil, page_number: nil, page_size: nil)
+              def page(reservation_status: nil, page_token: nil, page_number: nil, page_size: nil)
                 params = {
-                    'Status' => status,
-                    'AssignmentStatus' => assignment_status,
                     'ReservationStatus' => reservation_status,
                     'PageToken' => page_token,
                     'Page' => page_number,
@@ -217,7 +203,7 @@ module Twilio
               
               ##
               # Update the ReservationInstance
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @param [String] worker_activity_sid The worker_activity_sid
               # @param [String] instruction The instruction
               # @param [String] dequeue_post_work_activity_sid The
@@ -380,7 +366,7 @@ module Twilio
               
               ##
               # Update the ReservationInstance
-              # @param [String] reservation_status The reservation_status
+              # @param [reservation.Status] reservation_status The reservation_status
               # @param [String] worker_activity_sid The worker_activity_sid
               # @param [String] instruction The instruction
               # @param [String] dequeue_post_work_activity_sid The

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

@@ -442,7 +442,7 @@ module Twilio
             ##
             # Update the TaskInstance
             # @param [String] attributes The attributes
-            # @param [task.Status] assignment_status The assignment_status
+            # @param [reservation.Status] assignment_status The assignment_status
             # @param [String] reason The reason
             # @param [String] priority The priority
             # @return [TaskInstance] Updated TaskInstance

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

@@ -0,0 +1,426 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /       
+
+module Twilio
+  module REST
+    class Taskrouter < Domain
+      class V1 < Version
+        class WorkspaceContext < InstanceContext
+          class WorkerContext < InstanceContext
+            class ReservationList < ListResource
+              ##
+              # Initialize the ReservationList
+              # @param [Version] version Version that contains the resource
+              # @param [String] workspace_sid The workspace_sid
+              # @param [String] worker_sid The worker_sid
+              # @return [ReservationList] ReservationList
+              def initialize(version, workspace_sid: nil, worker_sid: nil)
+                super(version)
+                
+                # Path Solution
+                @solution = {
+                    workspace_sid: workspace_sid,
+                    worker_sid: worker_sid
+                }
+                @uri = "/Workspaces/#{@solution[:workspace_sid]}/Workers/#{@solution[:worker_sid]}/Reservations"
+              end
+              
+              ##
+              # Lists ReservationInstance records from the API as a list.
+              # Unlike stream(), this operation is eager and will load `limit` records into
+              # memory before returning.
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @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 not set will                      use
+              #  the default value of 50 records.  If no page_size is                      defined
+              #  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: nil, limit: nil, page_size: nil)
+                self.stream(
+                    reservation_status: reservation_status,
+                    limit: limit,
+                    page_size: page_size
+                ).entries
+              end
+              
+              ##
+              # Streams ReservationInstance records from the API as an Enumerable.
+              # This operation lazily loads records as efficiently as possible until the limit
+              # is reached.
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @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                      not set will use
+              #  the default value of 50 records.                      If no page_size is defined
+              #                       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: nil, limit: nil, page_size: nil)
+                limits = @version.read_limits(limit, page_size)
+                
+                page = self.page(
+                    reservation_status: reservation_status,
+                    page_size: limits[:page_size],
+                )
+                
+                @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+              end
+              
+              ##
+              # When passed a block, yields ReservationInstance records from the API.
+              # This operation lazily loads records as efficiently as possible until the limit
+              # is reached.
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @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                       not set will use
+              #  the default value of 50 records.                      If no page_size is defined
+              #                       but a limit is defined, stream() will attempt to read the
+              #                       limit with the most efficient page size, i.e. min(limit, 1000)
+              def each
+                limits = @version.read_limits
+                
+                page = self.page(
+                    page_size: limits[:page_size],
+                )
+                
+                @version.stream(page,
+                                limit: limits[:limit],
+                                page_limit: limits[:page_limit]).each {|x| yield x}
+              end
+              
+              ##
+              # Retrieve a single page of ReservationInstance records from the API.
+              # Request is executed immediately.
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @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: nil, page_token: nil, page_number: nil, page_size: nil)
+                params = {
+                    'ReservationStatus' => reservation_status,
+                    'PageToken' => page_token,
+                    'Page' => page_number,
+                    'PageSize' => page_size,
+                }
+                response = @version.page(
+                    'GET',
+                    @uri,
+                    params
+                )
+                return ReservationPage.new(@version, response, @solution)
+              end
+              
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Taskrouter.V1.ReservationList>'
+              end
+            end
+          
+            class ReservationPage < Page
+              ##
+              # Initialize the ReservationPage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @param [String] workspace_sid The workspace_sid
+              # @param [String] worker_sid The worker_sid
+              # @return [ReservationPage] ReservationPage
+              def initialize(version, response, solution)
+                super(version, response)
+                
+                # Path Solution
+                @solution = solution
+              end
+              
+              ##
+              # Build an instance of ReservationInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [ReservationInstance] ReservationInstance
+              def get_instance(payload)
+                return ReservationInstance.new(
+                    @version,
+                    payload,
+                    workspace_sid: @solution[:workspace_sid],
+                    worker_sid: @solution[:worker_sid],
+                )
+              end
+              
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Taskrouter.V1.ReservationPage>'
+              end
+            end
+          
+            class ReservationContext < InstanceContext
+              ##
+              # Initialize the ReservationContext
+              # @param [Version] version Version that contains the resource
+              # @param [String] workspace_sid The workspace_sid
+              # @param [String] worker_sid The worker_sid
+              # @param [String] sid The sid
+              # @return [ReservationContext] ReservationContext
+              def initialize(version, workspace_sid, worker_sid, sid)
+                super(version)
+                
+                # Path Solution
+                @solution = {
+                    workspace_sid: workspace_sid,
+                    worker_sid: worker_sid,
+                    sid: sid,
+                }
+                @uri = "/Workspaces/#{@solution[:workspace_sid]}/Workers/#{@solution[:worker_sid]}/Reservations/#{@solution[:sid]}"
+              end
+              
+              ##
+              # Fetch a ReservationInstance
+              # @return [ReservationInstance] Fetched ReservationInstance
+              def fetch
+                params = {}
+                
+                payload = @version.fetch(
+                    'GET',
+                    @uri,
+                    params,
+                )
+                
+                return ReservationInstance.new(
+                    @version,
+                    payload,
+                    workspace_sid: @solution[:workspace_sid],
+                    worker_sid: @solution[:worker_sid],
+                    sid: @solution[:sid],
+                )
+              end
+              
+              ##
+              # Update the ReservationInstance
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @param [String] worker_activity_sid The worker_activity_sid
+              # @param [String] instruction The instruction
+              # @param [String] dequeue_post_work_activity_sid The
+              #   dequeue_post_work_activity_sid
+              # @param [String] dequeue_from The dequeue_from
+              # @param [String] dequeue_record The dequeue_record
+              # @param [String] dequeue_timeout The dequeue_timeout
+              # @param [String] dequeue_to The dequeue_to
+              # @param [String] dequeue_status_callback_url The dequeue_status_callback_url
+              # @param [String] call_from The call_from
+              # @param [String] call_record The call_record
+              # @param [String] call_timeout The call_timeout
+              # @param [String] call_to The call_to
+              # @param [String] call_url The call_url
+              # @param [String] call_status_callback_url The call_status_callback_url
+              # @param [Boolean] call_accept The call_accept
+              # @param [String] redirect_call_sid The redirect_call_sid
+              # @param [Boolean] redirect_accept The redirect_accept
+              # @param [String] redirect_url The redirect_url
+              # @return [ReservationInstance] Updated ReservationInstance
+              def update(reservation_status: nil, worker_activity_sid: nil, instruction: nil, dequeue_post_work_activity_sid: nil, dequeue_from: nil, dequeue_record: nil, dequeue_timeout: nil, dequeue_to: nil, dequeue_status_callback_url: nil, call_from: nil, call_record: nil, call_timeout: nil, call_to: nil, call_url: nil, call_status_callback_url: nil, call_accept: nil, redirect_call_sid: nil, redirect_accept: nil, redirect_url: nil)
+                data = {
+                    'ReservationStatus' => reservation_status,
+                    'WorkerActivitySid' => worker_activity_sid,
+                    'Instruction' => instruction,
+                    'DequeuePostWorkActivitySid' => dequeue_post_work_activity_sid,
+                    'DequeueFrom' => dequeue_from,
+                    'DequeueRecord' => dequeue_record,
+                    'DequeueTimeout' => dequeue_timeout,
+                    'DequeueTo' => dequeue_to,
+                    'DequeueStatusCallbackUrl' => dequeue_status_callback_url,
+                    'CallFrom' => call_from,
+                    'CallRecord' => call_record,
+                    'CallTimeout' => call_timeout,
+                    'CallTo' => call_to,
+                    'CallUrl' => call_url,
+                    'CallStatusCallbackUrl' => call_status_callback_url,
+                    'CallAccept' => call_accept,
+                    'RedirectCallSid' => redirect_call_sid,
+                    'RedirectAccept' => redirect_accept,
+                    'RedirectUrl' => redirect_url,
+                }
+                
+                payload = @version.update(
+                    'POST',
+                    @uri,
+                    data: data,
+                )
+                
+                return ReservationInstance.new(
+                    @version,
+                    payload,
+                    workspace_sid: @solution[:workspace_sid],
+                    worker_sid: @solution[:worker_sid],
+                    sid: @solution[:sid],
+                )
+              end
+              
+              ##
+              # Provide a user friendly representation
+              def to_s
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Taskrouter.V1.ReservationContext #{context}>"
+              end
+            end
+          
+            class ReservationInstance < InstanceResource
+              ##
+              # Initialize the ReservationInstance
+              # @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] worker_sid The worker_sid
+              # @param [String] sid The sid
+              # @return [ReservationInstance] ReservationInstance
+              def initialize(version, payload, workspace_sid: nil, worker_sid: nil, sid: nil)
+                super(version)
+                
+                # Marshaled Properties
+                @properties = {
+                    'account_sid' => payload['account_sid'],
+                    'date_created' => Twilio.deserialize_iso8601(payload['date_created']),
+                    'date_updated' => Twilio.deserialize_iso8601(payload['date_updated']),
+                    'reservation_status' => payload['reservation_status'],
+                    'sid' => payload['sid'],
+                    'task_sid' => payload['task_sid'],
+                    'worker_name' => payload['worker_name'],
+                    'worker_sid' => payload['worker_sid'],
+                    'workspace_sid' => payload['workspace_sid'],
+                }
+                
+                # Context
+                @instance_context = nil
+                @params = {
+                    'workspace_sid' => workspace_sid,
+                    'worker_sid' => worker_sid,
+                    'sid' => sid || @properties['sid'],
+                }
+              end
+              
+              ##
+              # Generate an instance context for the instance, the context is capable of
+              # performing various actions.  All instance actions are proxied to the context
+              # @param [Version] version Version that contains the resource
+              # @return [ReservationContext] ReservationContext for this ReservationInstance
+              def context
+                unless @instance_context
+                  @instance_context = ReservationContext.new(
+                      @version,
+                      @params['workspace_sid'],
+                      @params['worker_sid'],
+                      @params['sid'],
+                  )
+                end
+                @instance_context
+              end
+              
+              def account_sid
+                @properties['account_sid']
+              end
+              
+              def date_created
+                @properties['date_created']
+              end
+              
+              def date_updated
+                @properties['date_updated']
+              end
+              
+              def reservation_status
+                @properties['reservation_status']
+              end
+              
+              def sid
+                @properties['sid']
+              end
+              
+              def task_sid
+                @properties['task_sid']
+              end
+              
+              def worker_name
+                @properties['worker_name']
+              end
+              
+              def worker_sid
+                @properties['worker_sid']
+              end
+              
+              def workspace_sid
+                @properties['workspace_sid']
+              end
+              
+              ##
+              # Fetch a ReservationInstance
+              # @return [ReservationInstance] Fetched ReservationInstance
+              def fetch
+                context.fetch
+              end
+              
+              ##
+              # Update the ReservationInstance
+              # @param [reservation.Status] reservation_status The reservation_status
+              # @param [String] worker_activity_sid The worker_activity_sid
+              # @param [String] instruction The instruction
+              # @param [String] dequeue_post_work_activity_sid The
+              #   dequeue_post_work_activity_sid
+              # @param [String] dequeue_from The dequeue_from
+              # @param [String] dequeue_record The dequeue_record
+              # @param [String] dequeue_timeout The dequeue_timeout
+              # @param [String] dequeue_to The dequeue_to
+              # @param [String] dequeue_status_callback_url The dequeue_status_callback_url
+              # @param [String] call_from The call_from
+              # @param [String] call_record The call_record
+              # @param [String] call_timeout The call_timeout
+              # @param [String] call_to The call_to
+              # @param [String] call_url The call_url
+              # @param [String] call_status_callback_url The call_status_callback_url
+              # @param [Boolean] call_accept The call_accept
+              # @param [String] redirect_call_sid The redirect_call_sid
+              # @param [Boolean] redirect_accept The redirect_accept
+              # @param [String] redirect_url The redirect_url
+              # @return [ReservationInstance] Updated ReservationInstance
+              def update(reservation_status: nil, worker_activity_sid: nil, instruction: nil, dequeue_post_work_activity_sid: nil, dequeue_from: nil, dequeue_record: nil, dequeue_timeout: nil, dequeue_to: nil, dequeue_status_callback_url: nil, call_from: nil, call_record: nil, call_timeout: nil, call_to: nil, call_url: nil, call_status_callback_url: nil, call_accept: nil, redirect_call_sid: nil, redirect_accept: nil, redirect_url: nil)
+                context.update(
+                    reservation_status: reservation_status,
+                    worker_activity_sid: worker_activity_sid,
+                    instruction: instruction,
+                    dequeue_post_work_activity_sid: dequeue_post_work_activity_sid,
+                    dequeue_from: dequeue_from,
+                    dequeue_record: dequeue_record,
+                    dequeue_timeout: dequeue_timeout,
+                    dequeue_to: dequeue_to,
+                    dequeue_status_callback_url: dequeue_status_callback_url,
+                    call_from: call_from,
+                    call_record: call_record,
+                    call_timeout: call_timeout,
+                    call_to: call_to,
+                    call_url: call_url,
+                    call_status_callback_url: call_status_callback_url,
+                    call_accept: call_accept,
+                    redirect_call_sid: redirect_call_sid,
+                    redirect_accept: redirect_accept,
+                    redirect_url: redirect_url,
+                )
+              end
+              
+              ##
+              # Provide a user friendly representation
+              def to_s
+                values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Taskrouter.V1.ReservationInstance #{values}>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -261,6 +261,7 @@ module Twilio
               
               # Dependents
               @statistics = nil
+              @reservations = nil
             end
             
             ##
@@ -328,6 +329,30 @@ module Twilio
               )
             end
             
+            ##
+            # Access the reservations
+            # @return [ReservationList] ReservationList
+            def reservations(sid=:unset)
+              if sid != :unset
+                return ReservationContext.new(
+                    @version,
+                    @solution[:workspace_sid],
+                    @solution[:sid],
+                    sid,
+                )
+              end
+              
+              unless @reservations
+                @reservations = ReservationList.new(
+                    @version,
+                    workspace_sid: @solution[:workspace_sid],
+                    worker_sid: @solution[:sid],
+                )
+              end
+              
+              @reservations
+            end
+            
             ##
             # Provide a user friendly representation
             def to_s
@@ -465,6 +490,13 @@ module Twilio
               context.statistics
             end
             
+            ##
+            # Access the reservations
+            # @return [reservations] reservations
+            def reservations
+              context.reservations
+            end
+            
             ##
             # Provide a user friendly representation
             def to_s

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-  VERSION = '5.0.0.rc13'
+  VERSION = '5.0.0.rc14'
 end

data/spec/integration/taskrouter/v1/workspace/worker/reservation_spec.rb

@@ -0,0 +1,192 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /       
+
+require 'spec_helper.rb'
+
+describe 'Reservation' do
+  it "can read" do
+    @holodeck.mock(Twilio::TwilioResponse.new(500, ''))
+    
+    expect {
+      @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .reservations.list()
+    }.to raise_exception(Twilio::REST::TwilioException)
+    
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations',
+    ))).to eq(true)
+  end
+
+  it "receives read_full responses" do
+    @holodeck.mock(Twilio::TwilioResponse.new(
+        200,
+      %q[
+      {
+          "meta": {
+              "first_page_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations?PageSize=50&Page=0",
+              "key": "reservations",
+              "next_page_url": null,
+              "page": 0,
+              "page_size": 50,
+              "previous_page_url": null,
+              "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations"
+          },
+          "reservations": [
+              {
+                  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "date_created": "2014-05-14T10:50:02Z",
+                  "date_updated": "2014-05-15T16:03:42Z",
+                  "links": {
+                      "task": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Tasks/WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                      "worker": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                      "workspace": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+                  },
+                  "reservation_status": "reserved",
+                  "sid": "WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "task_sid": "WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "worker_name": "Doug",
+                  "worker_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+              }
+          ]
+      }
+      ]
+    ))
+    
+    actual = @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .reservations.list()
+    
+    expect(actual).to_not eq(nil)
+  end
+
+  it "receives read_empty responses" do
+    @holodeck.mock(Twilio::TwilioResponse.new(
+        200,
+      %q[
+      {
+          "meta": {
+              "first_page_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations?PageSize=50&Page=0",
+              "key": "reservations",
+              "next_page_url": null,
+              "page": 0,
+              "page_size": 50,
+              "previous_page_url": null,
+              "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations"
+          },
+          "reservations": []
+      }
+      ]
+    ))
+    
+    actual = @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .reservations.list()
+    
+    expect(actual).to_not eq(nil)
+  end
+
+  it "can fetch" do
+    @holodeck.mock(Twilio::TwilioResponse.new(500, ''))
+    
+    expect {
+      @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .reservations("WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch()
+    }.to raise_exception(Twilio::REST::TwilioException)
+    
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+    ))).to eq(true)
+  end
+
+  it "receives fetch responses" do
+    @holodeck.mock(Twilio::TwilioResponse.new(
+        200,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "date_created": "2014-05-14T10:50:02Z",
+          "date_updated": "2014-05-15T16:03:42Z",
+          "links": {
+              "task": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Tasks/WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+              "worker": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+              "workspace": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+          },
+          "reservation_status": "reserved",
+          "sid": "WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "task_sid": "WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "worker_name": "Doug",
+          "worker_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      }
+      ]
+    ))
+    
+    actual = @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .reservations("WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch()
+    
+    expect(actual).to_not eq(nil)
+  end
+
+  it "can update" do
+    @holodeck.mock(Twilio::TwilioResponse.new(500, ''))
+    
+    expect {
+      @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                           .reservations("WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").update()
+    }.to raise_exception(Twilio::REST::TwilioException)
+    
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'post',
+        url: 'https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+    ))).to eq(true)
+  end
+
+  it "receives update responses" do
+    @holodeck.mock(Twilio::TwilioResponse.new(
+        200,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "date_created": "2014-05-14T10:50:02Z",
+          "date_updated": "2014-05-15T16:03:42Z",
+          "links": {
+              "task": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Tasks/WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+              "worker": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+              "workspace": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+          },
+          "reservation_status": "reserved",
+          "sid": "WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "task_sid": "WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "worker_name": "Doug",
+          "worker_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      }
+      ]
+    ))
+    
+    actual = @client.taskrouter.v1.workspaces("WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .workers("WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") \
+                                  .reservations("WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").update()
+    
+    expect(actual).to_not eq(nil)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 5.0.0.rc13
+  version: 5.0.0.rc14
 platform: ruby
 authors:
 - Andrew Benton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-03 00:00:00.000000000 Z
+date: 2016-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: builder
@@ -215,6 +215,7 @@ files:
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/task_queue/task_queue_statistics.rb
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/task_queue/task_queues_statistics.rb
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/worker.rb
+- lib/twilio-ruby/rest/taskrouter/v1/workspace/worker/reservation.rb
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/worker/worker_statistics.rb
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/worker/workers_statistics.rb
 - lib/twilio-ruby/rest/taskrouter/v1/workspace/workflow.rb
@@ -327,6 +328,7 @@ files:
 - spec/integration/taskrouter/v1/workspace/task_queue/task_queues_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/task_queue_spec.rb
 - spec/integration/taskrouter/v1/workspace/task_spec.rb
+- spec/integration/taskrouter/v1/workspace/worker/reservation_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker/worker_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker/workers_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker_spec.rb
@@ -481,6 +483,7 @@ test_files:
 - spec/integration/taskrouter/v1/workspace/task_queue/task_queues_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/task_queue_spec.rb
 - spec/integration/taskrouter/v1/workspace/task_spec.rb
+- spec/integration/taskrouter/v1/workspace/worker/reservation_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker/worker_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker/workers_statistics_spec.rb
 - spec/integration/taskrouter/v1/workspace/worker_spec.rb