twilio-ruby 5.28.0 → 5.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 486aaf4e71b9e38a32a027f43893b3c5098d3101
-  data.tar.gz: 2e1fe06a188821f8d14986fdd001044d57cc9744
+SHA256:
+  metadata.gz: 823cf1fc9cb2772927f2b02b9e2772a2a554743038cc3e64ebe61b7887edaec0
+  data.tar.gz: c5e0d12701240a1327d0ab16f843fa4daa060c6254d1bb0f707f04f1a39568bd
 SHA512:
-  metadata.gz: 0ed662a67c01c89d9153639e96009dbd41e58cceabd0aaca7a6dede0e9b147cced8117db87846eed49defdc89f9934dc8fe208e8747bcbe63db97e7e7315a7b0
-  data.tar.gz: fd2ddc21e809daef4c22373d75cbfb1f91606ee78d17dff9a8ec13986a56b97f1a94588bb59541db80f1b213a97784a603d7874dbebbd0f779fa054433c6530b
+  metadata.gz: 9ba643864523acc543eff047c6254a83354f883466c052cf95193c4d83f552e0a4a50393e559e488cf56e8c69b6eb9d7b6ea9180ff8f50064b66b405f6086d44
+  data.tar.gz: 2fd427e2e0b2a3237322a3c366dad641790bad79e44d4e36892cdd11f16d4c495720a7ba93e212ec6c9c207fdedf428f2aedf89c57847355d8f174b78d7d4d5e

data/.travis.yml

@@ -20,9 +20,14 @@ matrix:
   fast_finish: true
 
 deploy:
-  provider: script
-  script: make docker-build && make docker-push
-  skip_cleanup: true
-  on:
-    tags: true
-    rvm: "2.4"
+  - provider: script
+    script: make docker-build && make docker-push
+    skip_cleanup: true
+    on:
+      tags: true
+      rvm: "2.4"
+  - provider: rubygems
+    api_key: $RUBYGEMS_APIKEY
+    on:
+      tags: true
+      rvm: "2.4"

data/CHANGES.md

@@ -1,6 +1,39 @@
 twilio-ruby changelog
 =====================
 
+[2019-10-30] Version 5.29.0
+---------------------------
+**Library**
+- [PR #481](https://github.com/twilio/twilio-ruby/pull/481): added request validation for urls with and without ports. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+- [PR #480](https://github.com/twilio/twilio-ruby/pull/480): Update resources after sorting. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #479](https://github.com/twilio/twilio-ruby/pull/479): Auto-deploy via Travis CI upon tagged commit to master. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+
+**Api**
+- Add new usage categories to the public api `sms-messages-carrierfees` and `mms-messages-carrierfees`
+
+**Conversations**
+- Add ProjectedAddress to Conversations Participant resource
+
+**Preview**
+- Implemented different `Sid` for Current Calls (Verified by Twilio), instead of relying in `Call.Sid` from Voice API team **(breaking change)**
+
+**Supersim**
+- Add List endpoint to Commands resource for Super Sim Pilot
+- Add UsageRecords resource for the Super Sim Pilot
+- Add List endpoint to UsageRecords resource for the Super Sim Pilot
+- Allow assigning a Sim to a Fleet by Fleet SID or Unique Name for Super SIM Pilot
+- Add Update endpoint to Fleets resource for Super Sim Pilot
+- Add Fetch endpoint to Commands resource for Super Sim Pilot
+- Allow filtering the Sims resource List endpoint by Fleet
+- Add List endpoint to Fleets resource for Super Sim Pilot
+
+**Wireless**
+- Added `account_sid` to Sim update parameters.
+
+**Twiml**
+- Add new locales and voices for `Say` from Polly
+
+
 [2019-10-16] Version 5.28.0
 ---------------------------
 **Library**

data/README.md

@@ -2,6 +2,7 @@
 
 [![Build Status](https://img.shields.io/travis/twilio/twilio-ruby.svg)][travis]
 [![Gem Version](https://img.shields.io/gem/v/twilio-ruby.svg)](https://rubygems.org/gems/twilio-ruby)
+[![Learn with TwilioQuest](https://img.shields.io/static/v1?label=TwilioQuest&message=Learn%20to%20contribute%21&color=F22F46&labelColor=1f243c&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAASFBMVEUAAAAZGRkcHBwjIyMoKCgAAABgYGBoaGiAgICMjIyzs7PJycnMzMzNzc3UoBfd3d3m5ubqrhfrMEDu7u739/f4vSb/3AD///9tbdyEAAAABXRSTlMAAAAAAMJrBrEAAAKoSURBVHgB7ZrRcuI6EESdyxXGYoNFvMD//+l2bSszRgyUYpFAsXOeiJGmj4NkuWx1Qeh+Ekl9DgEXOBwOx+Px5xyQhDykfgq4wG63MxxaR4ddIkg6Ul3g84vCIcjPBA5gmUMeXESrlukuoK33+33uID8TWeLAdOWsKpJYzwVMB7bOzYSGOciyUlXSn0/ABXTosJ1M1SbypZ4O4MbZuIDMU02PMbauhhHMHXbmebmALIiEbbbbbUrpF1gwE9kFfRNAJaP+FQEXCCTGyJ4ngDrjOFo3jEL5JdqjF/pueR4cCeCGgAtwmuRS6gDwaRiGvu+DMFwSBLTE3+jF8JyuV1okPZ+AC4hDFhCHyHQjdjPHUKFDlHSJkHQXMB3KpSwXNGJPcwwTdZiXlRN0gSp0zpWxNtM0beYE0nRH6QIbO7rawwXaBYz0j78gxjokDuv12gVeUuBD0MDi0OQCLvDaAho4juP1Q/jkAncXqIcCfd+7gAu4QLMACCLxpRsSuQh0igu0C9Svhi7weAGZg50L3IE3cai4IfkNZAC8dfdhsUD3CgKBVC9JE5ABAFzg4QL/taYPAAWrHdYcgfLaIgAXWJ7OV38n1LEF8tt2TH29E+QAoDoO5Ve/LtCQDmKM9kPbvCEBApK+IXzbcSJ0cIGF6e8gpcRhUDogWZ8JnaWjPXc/fNnBBUKRngiHgTUSivSzDRDgHZQOLvBQgf8rRt+VdBUUhwkU6VpJ+xcOwQUqZr+mR0kvBUgv6cB4+37hQAkXqE8PwGisGhJtN4xAHMzrsgvI7rccXqSvKh6jltGlrOHA3Xk1At3LC4QiPdX9/0ndHpGVvTjR4bZA1ypAKgVcwE5vx74ulwIugDt8e/X7JgfkucBMIAr26ndnB4UCLnDOqvteQsHlgX9N4A+c4cW3DXSPbwAAAABJRU5ErkJggg==)](https://twil.io/learn-open-source)
 
 ## Documentation
 
@@ -29,13 +30,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.28.0'
+gem 'twilio-ruby', '~> 5.29.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.28.0
+gem install twilio-ruby -v 5.29.0
 ```
 
 To build and install the development branch yourself from the latest source:

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

@@ -58,7 +58,7 @@ module Twilio
             #   `completed`. If no event is specified, we send the `completed` status. If you
             #   want to receive multiple events, specify each one in a separate
             #   `status_callback_event` parameter. See the code sample for [monitoring call
-            #   progress](https://www.twilio.com/docs/voice/api/call?code-sample=code-create-a-call-and-specify-a-statuscallbackevent). If an `application_sid` is present, this parameter is ignored.
+            #   progress](https://www.twilio.com/docs/voice/api/call-resource?code-sample=code-create-a-call-resource-and-specify-a-statuscallbackevent&code-sdk-version=json). If an `application_sid` is present, this parameter is ignored.
             # @param [String] status_callback_method The HTTP method we should use when
             #   calling the `status_callback` URL. Can be: `GET` or `POST` and the default is
             #   `POST`. If an `application_sid` parameter is present, this parameter is ignored.
@@ -78,9 +78,9 @@ module Twilio
             #   seconds could result in an actual timeout closer to 15 seconds. You can set this
             #   to a short time, such as `15` seconds, to hang up before reaching an answering
             #   machine or voicemail.
-            # @param [Boolean] record Set this parameter to `true` to record the phone call.
-            #   The `recording_url` will be sent to the `status_callback` URL. The default is
-            #   `false`.
+            # @param [Boolean] record Whether to record the call. Can be `true` to record the
+            #   phone call, or `false` to not. The default is `false`. The `recording_url` is
+            #   sent to the `status_callback` URL.
             # @param [String] recording_channels The number of channels in the final
             #   recording. Can be: `mono` or `dual`. The default is `mono`. `mono` records both
             #   legs of the call in a single channel of the recording file. `dual` records each
@@ -96,12 +96,12 @@ module Twilio
             #   making a SIP call.
             # @param [String] sip_auth_password The password required to authenticate the user
             #   account specified in `sip_auth_username`.
-            # @param [String] machine_detection Detect if a human, answering machine, or fax
-            #   has picked up the call. Can be: `Enable` or `DetectMessageEnd`. Use `Enable` if
-            #   you would like us to return `AnsweredBy` as soon as the called party is
-            #   identified. Use `DetectMessageEnd`, if you would like to leave a message on an
-            #   answering machine. If `send_digits` is provided, this parameter is ignored. For
-            #   more information, see [Answering Machine
+            # @param [String] machine_detection Whether to detect if a human, answering
+            #   machine, or fax has picked up the call. Can be: `Enable` or `DetectMessageEnd`.
+            #   Use `Enable` if you would like us to return `AnsweredBy` as soon as the called
+            #   party is identified. Use `DetectMessageEnd`, if you would like to leave a
+            #   message on an answering machine. If `send_digits` is provided, this parameter is
+            #   ignored. For more information, see [Answering Machine
             #   Detection](https://www.twilio.com/docs/voice/answering-machine-detection).
             # @param [String] machine_detection_timeout The number of seconds that we should
             #   attempt to detect an answering machine before timing out and sending a voice
@@ -178,8 +178,8 @@ module Twilio
             # Lists CallInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] to Only show calls to this phone number, SIP address, Client
-            #   identifier or SIM SID.
+            # @param [String] to Only show calls made to this phone number, SIP address,
+            #   Client identifier or SIM SID.
             # @param [String] from Only include calls from this phone number, SIP address,
             #   Client identifier or SIM SID.
             # @param [String] parent_call_sid Only include calls spawned by calls with this
@@ -221,8 +221,8 @@ module Twilio
             # Streams CallInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] to Only show calls to this phone number, SIP address, Client
-            #   identifier or SIM SID.
+            # @param [String] to Only show calls made to this phone number, SIP address,
+            #   Client identifier or SIM SID.
             # @param [String] from Only include calls from this phone number, SIP address,
             #   Client identifier or SIM SID.
             # @param [String] parent_call_sid Only include calls spawned by calls with this
@@ -280,8 +280,8 @@ module Twilio
             ##
             # Retrieve a single page of CallInstance records from the API.
             # Request is executed immediately.
-            # @param [String] to Only show calls to this phone number, SIP address, Client
-            #   identifier or SIM SID.
+            # @param [String] to Only show calls made to this phone number, SIP address,
+            #   Client identifier or SIM SID.
             # @param [String] from Only include calls from this phone number, SIP address,
             #   Client identifier or SIM SID.
             # @param [String] parent_call_sid Only include calls spawned by calls with this
@@ -395,8 +395,7 @@ module Twilio
             # @param [String] account_sid The SID of the
             #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Call
             #   resource(s) to fetch.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the Call
-            #   resource to fetch
+            # @param [String] sid The SID of the Call resource to fetch.
             # @return [CallContext] CallContext
             def initialize(version, account_sid, sid)
               super(version)
@@ -561,8 +560,7 @@ module Twilio
             # @param [String] account_sid The SID of the
             #   [Account](https://www.twilio.com/docs/iam/api/account) that created this Call
             #   resource.
-            # @param [String] sid The Twilio-provided string that uniquely identifies the Call
-            #   resource to fetch
+            # @param [String] sid The SID of the Call resource to fetch.
             # @return [CallInstance] CallInstance
             def initialize(version, payload, account_sid: nil, sid: nil)
               super(version)

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

@@ -20,8 +20,8 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Call
               #   Notification resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call) the Call Notification
-              #   resource is associated with.
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Call
+              #   Notification resource is associated with.
               # @return [NotificationList] NotificationList
               def initialize(version, account_sid: nil, call_sid: nil)
                 super(version)
@@ -196,8 +196,9 @@ module Twilio
               # @param [String] account_sid The SID of the
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Call
               #   Notification resource to fetch.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the Call Notification resource to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the Call
+              #   Notification resource to fetch.
               # @param [String] sid The Twilio-provided string that uniquely identifies the Call
               #   Notification resource to fetch.
               # @return [NotificationContext] NotificationContext
@@ -261,8 +262,8 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Call
               #   Notification resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call) the Call Notification
-              #   resource is associated with.
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Call
+              #   Notification resource is associated with.
               # @param [String] sid The Twilio-provided string that uniquely identifies the Call
               #   Notification resource to fetch.
               # @return [NotificationInstance] NotificationInstance

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

@@ -20,8 +20,8 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   Recording resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call) the Recording resource is
-              #   associated with.
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording
+              #   resource is associated with.
               # @return [RecordingList] RecordingList
               def initialize(version, account_sid: nil, call_sid: nil)
                 super(version)
@@ -231,8 +231,9 @@ module Twilio
               # @param [String] account_sid The SID of the
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   Recording resource to fetch.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the resource to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource
+              #   to fetch.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Recording resource to fetch.
               # @return [RecordingContext] RecordingContext
@@ -324,8 +325,8 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   Recording resource.
               # @param [String] call_sid The SID of the
-              #   [Call](https://www.twilio.com/docs/voice/api/call) the Recording resource is
-              #   associated with.
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording
+              #   resource is associated with.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Recording resource to fetch.
               # @return [RecordingInstance] RecordingInstance

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

@@ -337,8 +337,9 @@ module Twilio
               #   Participant resource to fetch.
               # @param [String] conference_sid The SID of the conference with the participant to
               #   fetch.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the resource to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource
+              #   to fetch.
               # @return [ParticipantContext] ParticipantContext
               def initialize(version, account_sid, conference_sid, call_sid)
                 super(version)
@@ -468,8 +469,9 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   Participant resource.
               # @param [String] conference_sid The SID of the conference the participant is in.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the resource to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource
+              #   to fetch.
               # @return [ParticipantInstance] ParticipantInstance
               def initialize(version, payload, account_sid: nil, conference_sid: nil, call_sid: nil)
                 super(version)

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

@@ -218,13 +218,6 @@ module Twilio
               )
             end
 
-            ##
-            # Deletes the NotificationInstance
-            # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              @version.delete('delete', @uri)
-            end
-
             ##
             # Provide a user friendly representation
             def to_s
@@ -400,13 +393,6 @@ module Twilio
               context.fetch
             end
 
-            ##
-            # Deletes the NotificationInstance
-            # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
-            end
-
             ##
             # Provide a user friendly representation
             def to_s

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

@@ -171,7 +171,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
             #   [Account](https://www.twilio.com/docs/iam/api/account) that created the Queue
-            #   resource(s) to fetch.
+            #   resource to fetch.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Queue resource to fetch
             # @return [QueueContext] QueueContext

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

@@ -161,8 +161,9 @@ module Twilio
               #   resource(s) to fetch.
               # @param [String] queue_sid The SID of the Queue in which to find the members to
               #   fetch.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the resource(s) to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the
+              #   resource(s) to fetch.
               # @return [MemberContext] MemberContext
               def initialize(version, account_sid, queue_sid, call_sid)
                 super(version)
@@ -242,8 +243,9 @@ module Twilio
               #   [Account](https://www.twilio.com/docs/iam/api/account) that created this Queue
               #   resource.
               # @param [String] queue_sid The SID of the Queue the member is in.
-              # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-              #   SID of the resource(s) to fetch.
+              # @param [String] call_sid The
+              #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the
+              #   resource(s) to fetch.
               # @return [MemberInstance] MemberInstance
               def initialize(version, payload, account_sid: nil, queue_sid: nil, call_sid: nil)
                 super(version)

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

@@ -34,8 +34,9 @@ module Twilio
             # @param [Time] date_created_before Only include recordings that were created on this date
             # @param [Time] date_created Only include recordings that were created on this date
             # @param [Time] date_created_after Only include recordings that were created on this date
-            # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-            #   SID of the resources to read.
+            # @param [String] call_sid The
+            #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resources
+            #   to read.
             # @param [String] conference_sid The Conference SID that identifies the conference
             #   associated with the recording to read.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
@@ -64,8 +65,9 @@ module Twilio
             # @param [Time] date_created_before Only include recordings that were created on this date
             # @param [Time] date_created Only include recordings that were created on this date
             # @param [Time] date_created_after Only include recordings that were created on this date
-            # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-            #   SID of the resources to read.
+            # @param [String] call_sid The
+            #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resources
+            #   to read.
             # @param [String] conference_sid The Conference SID that identifies the conference
             #   associated with the recording to read.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
@@ -110,8 +112,9 @@ module Twilio
             # @param [Time] date_created_before Only include recordings that were created on this date
             # @param [Time] date_created Only include recordings that were created on this date
             # @param [Time] date_created_after Only include recordings that were created on this date
-            # @param [String] call_sid The [Call](https://www.twilio.com/docs/voice/api/call)
-            #   SID of the resources to read.
+            # @param [String] call_sid The
+            #   [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resources
+            #   to read.
             # @param [String] conference_sid The Conference SID that identifies the conference
             #   associated with the recording to read.
             # @param [String] page_token PageToken provided by the API

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

@@ -28,14 +28,6 @@ module Twilio
         @v1 ||= V1.new self
       end
 
-      ##
-      # @param [String] sid A 34 character string that uniquely identifies this Service.
-      # @return [Twilio::REST::Authy::V1::ServiceInstance] if sid was passed.
-      # @return [Twilio::REST::Authy::V1::ServiceList]
-      def services(sid=:unset)
-        self.v1.services(sid)
-      end
-
       ##
       # @param [form.FormTypes] form_type The Type of this Form. One of `form-app-push`,
       #   `form-sms` or `form-totp`.
@@ -45,6 +37,14 @@ module Twilio
         self.v1.forms(form_type)
       end
 
+      ##
+      # @param [String] sid A 34 character string that uniquely identifies this Service.
+      # @return [Twilio::REST::Authy::V1::ServiceInstance] if sid was passed.
+      # @return [Twilio::REST::Authy::V1::ServiceList]
+      def services(sid=:unset)
+        self.v1.services(sid)
+      end
+
       ##
       # Provide a user friendly representation
       def to_s

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

@@ -15,22 +15,8 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
-          @services = nil
           @forms = nil
-        end
-
-        ##
-        # @param [String] sid A 34 character string that uniquely identifies this Service.
-        # @return [Twilio::REST::Authy::V1::ServiceContext] if sid was passed.
-        # @return [Twilio::REST::Authy::V1::ServiceList]
-        def services(sid=:unset)
-          if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
-          else
-            ServiceContext.new(self, sid)
-          end
+          @services = nil
         end
 
         ##
@@ -48,6 +34,20 @@ module Twilio
           end
         end
 
+        ##
+        # @param [String] sid A 34 character string that uniquely identifies this Service.
+        # @return [Twilio::REST::Authy::V1::ServiceContext] if sid was passed.
+        # @return [Twilio::REST::Authy::V1::ServiceList]
+        def services(sid=:unset)
+          if sid.nil?
+            raise ArgumentError, 'sid cannot be nil'
+          elsif sid == :unset
+            @services ||= ServiceList.new self
+          else
+            ServiceContext.new(self, sid)
+          end
+        end
+
         ##
         # Provide a user friendly representation
         def to_s