twilio-ruby 5.35.0 → 5.39.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a3e996f0e5e03d78e9be169b6254e444bac36f39c70a6c8ff1a0a682b672866
-  data.tar.gz: 3ccf875613f2bcce4316fa3e35ccdfa25bb5eefb0aeb1f424a388f5cf9e9ae23
+  metadata.gz: 1fdc4e2781cfb9b6a282ef7231251f6da2d92b54759750cbb09ad7d740af7b9f
+  data.tar.gz: 8cc7809e41c1da0ee5764c9683b6f5cfc87a5b63eba2fd1e00071c0286520ea4
 SHA512:
-  metadata.gz: 98f01d3f1f616b93ae64d25bdd6de991dc85c6c5b7a774b059aa60d07b3fe28650b05e0a73e234dbff7f16c4d405af298c7547596c7e19eda03bc618a875ffcd
-  data.tar.gz: 6a4ed10718140c2c528f0b053f2f34167d39d40283fc226b59bb7f0563137e953019ad0fd84d27f731f1994f64a8b1c2b0c3391aeed4b096cec6d1b7b252a68d
+  metadata.gz: 9637c20fa554711bd82194b9af9cbf1f19ee22b65ef3259364896f4887c88c6b319a33ff22e500ca892a42b3cf3bf5b7e4c772bec591ff9eaac886f461f06e11
+  data.tar.gz: eecc1ee22886d77f2e91ce00c90198a94bad7fbf890a992bd27848b1a9082dfbb249a1f48dacea95f8da2dda1190b0be92aa919f5f20ee38562c7a3fc7c067bb

data/CHANGES.md

@@ -1,6 +1,132 @@
 twilio-ruby changelog
 =====================
 
+[2020-07-10] Version 5.39.1
+---------------------------
+**Library - Fix**
+- [PR #520](https://github.com/twilio/twilio-ruby/pull/520): use ruby keyword arguments for all action methods. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+
+[2020-07-08] Version 5.39.0
+---------------------------
+**Library - Feature**
+- [PR #516](https://github.com/twilio/twilio-ruby/pull/516): add custom header support. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Library - Chore**
+- [PR #515](https://github.com/twilio/twilio-ruby/pull/515): regenerate library after generator refactor. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Conversations**
+- Allow Address updates for Participants
+- Message delivery receipts
+
+**Events**
+- Add account_sid to subscription and subscribed_events resources
+
+**Flex**
+- Changed `wfm_integrations` Flex Configuration key to private **(breaking change)**
+
+**Messaging**
+- Add error states to WhatsApp Sender status with failed reason **(breaking change)**
+- Delete WhatsApp Template API
+- Update WhatsApp Template API
+- Add WhatsApp Template Get Api (fetch and read)
+
+**Numbers**
+- Add `valid_until` in the Bundles resource
+- Add API for Bundle deletion
+
+**Verify**
+- Removed support for `sms`, `totp` and `app-push` factor types in Verify push **(breaking change)**
+
+
+[2020-06-24] Version 5.38.0
+---------------------------
+**Api**
+- Added optional `JitterBufferSize` parameter for creating conference participant
+- Added optional `label` property for conference participants
+- Added optional parameter `caller_id` for creating conference participant endpoint.
+
+**Autopilot**
+- Remove Export resource from Autopilot Assistant
+
+**Conversations**
+- Expose Conversation timers
+
+**Monitor**
+- Update start/end date filter params to support date-or-time format **(breaking change)**
+
+**Numbers**
+- Add `provisionally-approved` as a Supporting Document status
+
+**Preview**
+- Removed `Authy` resources. **(breaking change)**
+
+**Supersim**
+- Add ready state to the allowed transitions in the sim update call behind the feature flag supersim.ready-state.v1
+
+**Verify**
+- Webhook resources added to Verify services and put behind the `api.verify.push` beta feature
+
+**Twiml**
+- Add more supported locales for the `Gather` verb.
+
+
+[2020-06-10] Version 5.37.0
+---------------------------
+**Library - Docs**
+- [PR #514](https://github.com/twilio/twilio-ruby/pull/514): link to handling exceptions. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #513](https://github.com/twilio/twilio-ruby/pull/513): link to custom HTTP client instructions. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+
+**Api**
+- Added `pstnconnectivity` to `usage_record` API
+
+**Autopilot**
+- Add dialogue_sid param to Query list resource
+
+**Notify**
+- delivery_callback_url and delivery_callback_enabled added
+
+**Numbers**
+- Add `provisionally-approved` as a Bundle status
+
+**Preview**
+- `BrandsInformation` endpoint now returns a single `BrandsInformation`
+- Deleted phone number required field in the brand phone number endpoint from `kyc-api`
+- Removed insights `preview API` from API Definitions **(breaking change)**
+- Added `BrandsInformation` endpoint to query brands information stored in KYC
+
+**Supersim**
+- Require a Network Access Profile when creating a Fleet **(breaking change)**
+
+
+[2020-05-27] Version 5.36.0
+---------------------------
+**Api**
+- Added `reason_conference_ended` and `call_sid_ending_conference` to Conference read/fetch/update
+- Fixed some examples to use the correct "TK" SID prefix for Trunk resources.
+
+**Authy**
+- Renamed `twilio_authy_sandbox_mode` headers to `twilio_sandbox_mode` **(breaking change)**
+- Renamed `Twilio-Authy-*` headers to `Twilio-Veriry-*` **(breaking change)**
+
+**Flex**
+- Adding `flex_service_instance_sid` to Flex Configuration
+
+**Preview**
+- Removed insights preview API from API Definitions **(breaking change)**
+- Added `Channels` endpoint to brand a phone number for BrandedCalls
+
+**Serverless**
+- Add Build Sid to Log results
+
+**Supersim**
+- Add Network Access Profile resource Networks subresource
+- Allow specifying a Data Limit on Fleets
+
+**Trunking**
+- Fixed some examples to use the correct "TK" SID prefix for Trunk resources.
+
+
 [2020-05-20] Version 5.35.0
 ---------------------------
 **Library - Feature**

data/README.md

@@ -32,13 +32,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.35.0'
+gem 'twilio-ruby', '~> 5.39.1'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.35.0
+gem install twilio-ruby -v 5.39.1
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -66,6 +66,8 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 
 ### Specify a Region and/or Edge
 
+To take advantage of Twilio's [Global Infrastructure](https://www.twilio.com/docs/global-infrastructure), specify the target Region and/or Edge for the client:
+
 ```ruby
 # set up a client to talk to the Twilio REST API over a specific region and edge
 @client = Twilio::REST::Client.new account_sid, auth_token, nil, 'au1'
@@ -121,16 +123,20 @@ message_sid = 'SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
 @client.http_client.adapter = :typhoeus
 ```
 
+To use a custom HTTP client with this helper library, please see the [Twilio documentation](https://www.twilio.com/docs/libraries/ruby/custom-http-clients).
+
 ### Handling Errors
 
 ```ruby
 begin
   messages = @client.messages.list(limit: 20)
-rescue Twilio::REST::TwilioError => e
+rescue Twilio::REST::RestError => e
   puts e.message
 end
 ```
 
+For more descriptive exception types, please see the [Twilio documentation](https://www.twilio.com/docs/libraries/ruby/usage-guide#error-handling).
+
 ### Getting Started With Client Capability Tokens
 
 If you just need to generate a Capability Token for use with Twilio Client, you can do this:

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

@@ -57,7 +57,7 @@ module Twilio
         Twilio::REST::RestError.new(header, response)
       end
 
-      def fetch(method, uri, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+      def fetch(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         response = request(
           method,
           uri,
@@ -93,7 +93,7 @@ module Twilio
         response.body
       end
 
-      def delete(method, uri, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+      def delete(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         response = request(
           method,
           uri,
@@ -127,7 +127,7 @@ module Twilio
         }
       end
 
-      def page(method, uri, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+      def page(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         request(
           method,
           uri,

data/lib/twilio-ruby/rest/accounts/v1/credential/aws.rb

@@ -85,11 +85,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               AwsPage.new(@version, response, @solution)
             end
 
@@ -107,8 +105,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of AwsInstance records from the API.
-            # Request is executed immediately.
+            # Create the AwsInstance
             # @param [String] credentials A string that contains the AWS access credentials in
             #   the format `<AWS_ACCESS_KEY_ID>:<AWS_SECRET_ACCESS_KEY>`. For example,
             #   `AKIAIOSFODNN7EXAMPLE:wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`
@@ -117,7 +114,7 @@ module Twilio
             # @param [String] account_sid The SID of the Subaccount that this Credential
             #   should be associated with. Must be a valid Subaccount of the account issuing the
             #   request.
-            # @return [AwsInstance] Newly created AwsInstance
+            # @return [AwsInstance] Created AwsInstance
             def create(credentials: nil, friendly_name: :unset, account_sid: :unset)
               data = Twilio::Values.of({
                   'Credentials' => credentials,
@@ -125,11 +122,7 @@ module Twilio
                   'AccountSid' => account_sid,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               AwsInstance.new(@version, payload, )
             end
@@ -186,16 +179,10 @@ module Twilio
             end
 
             ##
-            # Fetch a AwsInstance
+            # Fetch the AwsInstance
             # @return [AwsInstance] Fetched AwsInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               AwsInstance.new(@version, payload, sid: @solution[:sid], )
             end
@@ -208,20 +195,16 @@ module Twilio
             def update(friendly_name: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               AwsInstance.new(@version, payload, sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the AwsInstance
+            # Delete the AwsInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -313,7 +296,7 @@ module Twilio
             end
 
             ##
-            # Fetch a AwsInstance
+            # Fetch the AwsInstance
             # @return [AwsInstance] Fetched AwsInstance
             def fetch
               context.fetch
@@ -329,7 +312,7 @@ module Twilio
             end
 
             ##
-            # Deletes the AwsInstance
+            # Delete the AwsInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

data/lib/twilio-ruby/rest/accounts/v1/credential/public_key.rb

@@ -85,11 +85,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               PublicKeyPage.new(@version, response, @solution)
             end
 
@@ -107,8 +105,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of PublicKeyInstance records from the API.
-            # Request is executed immediately.
+            # Create the PublicKeyInstance
             # @param [String] public_key A URL encoded representation of the public key. For
             #   example, `-----BEGIN PUBLIC KEY-----MIIBIjANB.pa9xQIDAQAB-----END PUBLIC
             #   KEY-----`
@@ -117,7 +114,7 @@ module Twilio
             # @param [String] account_sid The SID of the Subaccount that this Credential
             #   should be associated with. Must be a valid Subaccount of the account issuing the
             #   request
-            # @return [PublicKeyInstance] Newly created PublicKeyInstance
+            # @return [PublicKeyInstance] Created PublicKeyInstance
             def create(public_key: nil, friendly_name: :unset, account_sid: :unset)
               data = Twilio::Values.of({
                   'PublicKey' => public_key,
@@ -125,11 +122,7 @@ module Twilio
                   'AccountSid' => account_sid,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               PublicKeyInstance.new(@version, payload, )
             end
@@ -186,16 +179,10 @@ module Twilio
             end
 
             ##
-            # Fetch a PublicKeyInstance
+            # Fetch the PublicKeyInstance
             # @return [PublicKeyInstance] Fetched PublicKeyInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               PublicKeyInstance.new(@version, payload, sid: @solution[:sid], )
             end
@@ -208,20 +195,16 @@ module Twilio
             def update(friendly_name: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               PublicKeyInstance.new(@version, payload, sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the PublicKeyInstance
+            # Delete the PublicKeyInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -313,7 +296,7 @@ module Twilio
             end
 
             ##
-            # Fetch a PublicKeyInstance
+            # Fetch the PublicKeyInstance
             # @return [PublicKeyInstance] Fetched PublicKeyInstance
             def fetch
               context.fetch
@@ -329,7 +312,7 @@ module Twilio
             end
 
             ##
-            # Deletes the PublicKeyInstance
+            # Delete the PublicKeyInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

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

@@ -24,19 +24,14 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of AccountInstance records from the API.
-          # Request is executed immediately.
+          # Create the AccountInstance
           # @param [String] friendly_name A human readable description of the account to
           #   create, defaults to `SubAccount Created at {YYYY-MM-DD HH:MM meridian}`
-          # @return [AccountInstance] Newly created AccountInstance
+          # @return [AccountInstance] Created AccountInstance
           def create(friendly_name: :unset)
             data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             AccountInstance.new(@version, payload, )
           end
@@ -121,11 +116,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             AccountPage.new(@version, response, @solution)
           end
 
@@ -220,16 +213,10 @@ module Twilio
           end
 
           ##
-          # Fetch a AccountInstance
+          # Fetch the AccountInstance
           # @return [AccountInstance] Fetched AccountInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             AccountInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -245,11 +232,7 @@ module Twilio
           def update(friendly_name: :unset, status: :unset)
             data = Twilio::Values.of({'FriendlyName' => friendly_name, 'Status' => status, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             AccountInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -764,7 +747,7 @@ module Twilio
           end
 
           ##
-          # Fetch a AccountInstance
+          # Fetch the AccountInstance
           # @return [AccountInstance] Fetched AccountInstance
           def fetch
             context.fetch