twilio-ruby 4.13.0 → 5.40.0

data/CHANGES.md

@@ -1,117 +1,1778 @@
 twilio-ruby changelog
 =====================
 
-Version 4.13.0
---------------
+[2020-08-19] Version 5.40.0
+---------------------------
+**Library - Chore**
+- [PR #526](https://github.com/twilio/twilio-ruby/pull/526): update GitHub branch references to use HEAD. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
 
-Released September 19, 2016:
+**Conversations**
+- Allow Identity addition to Participants
 
-- Add VideoGrant.
+**Events**
+- Sinks API Get all Sinks
 
-Version 4.12.1
---------------
+**Proxy**
+- Clarified usage of FailOnParticipantConflict param as experimental
+- Add FailOnParticipantConflict param to Proxy Session create and Proxy Participant create
 
-Released September 1, 2016:
+**Supersim**
+- Add fleet, network, and isoCountryCode to the UsageRecords resource
+- Change sort order of UsageRecords from ascending to descending with respect to start time field, records are now returned newest to oldest
 
-- Add VoiceGrant.
+**Wireless**
+- Removed `Start` and `End` parameters from the Data Sessions list endpoint. **(breaking change)**
 
-Version 4.11.1
--------------
 
-Released February 12, 2016:
+[2020-08-05] Version 5.39.3
+---------------------------
+**Messaging**
+- Add rejection reason support to WhatsApp API
+- Removed status parameter for create and update in WhatsApp Templates API
 
-- Add missing Keys mount to Account
+**Proxy**
+- Add FailOnParticipantConflict param to Proxy Session update
 
-Version 4.11.0
--------------
+**Verify**
+- Add `CustomFriendlyName` optional parameter on Verification creation.
+- Changes in `Challenge` resource to update documentation of both `details` and `hidden_details` properties.
 
-Released January 28, 2016:
 
-- Add support for alternative auth (eg. Keys)
+[2020-07-22] Version 5.39.2
+---------------------------
+**Api**
+- Add optional Click Tracking and Scheduling parameters to Create action of Message resource
 
-Version 4.10.0
--------------
+**Supersim**
+- Add callback_url and callback_method parameters to Sim resource update request
 
-Released January 28, 2016:
 
-- Add support for filter_friendly_name in WorkflowConfig
-- Load reservations by default in TaskRouter
+[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)!
 
-Version 4.9.1
--------------
 
-Release January 28, 2016
+[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)!
 
-- Fix ip messaging first person grant
+**Library - Chore**
+- [PR #515](https://github.com/twilio/twilio-ruby/pull/515): regenerate library after generator refactor. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
 
-Version 4.9.0
--------------
+**Conversations**
+- Allow Address updates for Participants
+- Message delivery receipts
 
-Release December 17, 2015
+**Events**
+- Add account_sid to subscription and subscribed_events resources
 
-- Release ip messaging
+**Flex**
+- Changed `wfm_integrations` Flex Configuration key to private **(breaking change)**
 
-Version 4.8.0
--------------
+**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)
 
-Release December 8, 2015
+**Numbers**
+- Add `valid_until` in the Bundles resource
+- Add API for Bundle deletion
 
-- Make nbf optional
+**Verify**
+- Removed support for `sms`, `totp` and `app-push` factor types in Verify push **(breaking change)**
 
-Version 4.7.0
--------------
 
-Release December 3, 2015
+[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.
 
-- Add access tokens
+**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**
+- [PR #512](https://github.com/twilio/twilio-ruby/pull/512): add regional and edge support. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+
+[2020-05-13] Version 5.34.1
+---------------------------
+**Api**
+- Add optional `emergency_caller_sid` parameter to SIP Domain
+- Updated `call_reason` optional property to be treated as PII
+- Added optional BYOC Trunk Sid property to Sip Domain API resource
+
+**Autopilot**
+- Add Restore resource to Autopilot Assistant
+
+**Contacts**
+- Added contacts Create API definition
+
+**Events**
+- Subscriptions API initial release
+
+**Numbers**
+- Add Evaluations API
+
+**Supersim**
+- Allow filtering the Fleets resource by Network Access Profile
+- Allow assigning a Network Access Profile when creating and updating a Fleet
+- Add Network Access Profiles resource
+
+**Verify**
+- Add `CustomCode` optional parameter on Verification creation.
+- Add delete action on Service resource.
+
+**Voice**
+- Added endpoints for BYOC trunks, SIP connection policies and source IP mappings
+
+
+[2020-04-29] Version 5.34.0
+---------------------------
+**Library - Feature**
+- [PR #511](https://github.com/twilio/twilio-ruby/pull/511): add details to error object. Thanks to [@ashish-s](https://github.com/ashish-s)!
+
+**Preview**
+- Added `Dispatch` version to `preview`
+
+**Studio**
+- Reroute Create Execution for V2 to the V2 downstream
+
+**Supersim**
+- Add Networks resource
+
+
+[2020-04-15] Version 5.33.1
+---------------------------
+**Library - Fix**
+- [PR #506](https://github.com/twilio/twilio-ruby/pull/506): loosen the faraday version requirement. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Library - Chore**
+- [PR #508](https://github.com/twilio/twilio-ruby/pull/508): Refer to https:// homepage in gemspec. Thanks to [@olleolleolle](https://github.com/olleolleolle)!
+- [PR #507](https://github.com/twilio/twilio-ruby/pull/507): Travis: Drop unused "sudo: false" directive. Thanks to [@olleolleolle](https://github.com/olleolleolle)!
+- [PR #498](https://github.com/twilio/twilio-ruby/pull/498): autoload TwiML to save memory on load. Thanks to [@philnash](https://github.com/philnash)!
+- [PR #499](https://github.com/twilio/twilio-ruby/pull/499): autoload JWT classes. Thanks to [@philnash](https://github.com/philnash)!
+- [PR #505](https://github.com/twilio/twilio-ruby/pull/505): remove S3 URLs from test data. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Api**
+- Updated description for property `call_reason` in the call create request
+
+**Contacts**
+- Added Read, Delete All, and Delete by SID docs
+- Initial Release
+
+**Studio**
+- Rename `flow_valid` to `flow_validate`
+- Removed `errors` and `warnings` from flows error response and added new property named `details`
+- Add Update Execution endpoints to v1 and v2 to end execution via API
+- Add new `warnings` attribute v2 flow POST api
+
+**Twiml**
+- Add enhanced attribute to use with `speech_model` for the `Gather` verb
+
+
+[2020-04-01] Version 5.33.0
+---------------------------
+**Library - Chore**
+- [PR #502](https://github.com/twilio/twilio-ruby/pull/502): Fix a typo in JWT::TaskRouterUtils. Thanks to [@rywall](https://github.com/rywall)!
+
+**Api**
+- Add optional 'secure' parameter to SIP Domain
+
+**Authy**
+- Added an endpoint to list the challenges of a factor
+- Added optional parameter `Push` when updating a service to send the service level push factor configuration
+
+**Bulkexports**
+- exposing bulk exports (vault/slapchop) API as public beta API
+
+**Flex**
+- Adding `queue_stats_configuration` and `wfm_integrations` to Flex Configuration
+
+**Serverless**
+- Add Function Version Content endpoint
+- Allow build_sid to be optional for deployment requests
+
+**Supersim**
+- Remove `deactivated` status for Super SIM which is replaced by `inactive` **(breaking change)**
+
+
+[2020-03-18] Version 5.32.0
+---------------------------
+**Api**
+- Add optional `emergency_calling_enabled` parameter to SIP Domain
+- Add optional property `call_reason` in the call create request
+
+**Authy**
+- Added `friendly_name` and `config` as optional params to Factor update
+- Added `config` param to Factor creation **(breaking change)**
+
+**Preview**
+- Renamed `SuccessRate` endpoint to `ImpressionsRate` for Branded Calls (fka. Verified by Twilio) **(breaking change)**
+
+
+[2020-03-04] Version 5.31.6
+---------------------------
+**Library - Chore**
+- [PR #497](https://github.com/twilio/twilio-ruby/pull/497): clean up and upgrade dev dependencies. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Authy**
+- Added the `configuration` property to services to return the service level configurations
+- Added optional parameter `Push` when creating a service to send the service level push factor configuration
+- Remove FactorStrength support for Factors and Challenges **(breaking change)**
+
+**Messaging**
+- Correct the alpha sender capabilities property type **(breaking change)**
+
+**Preview**
+- Removed `/Devices` register Branded Calls endpoint, as per iOS sample app deprecation **(breaking change)**
+- Removed `Twilio-Sandbox-Mode` request header from the Branded Calls endpoints, as not officially supported **(breaking change)**
+- Removed `Verify` version from `preview` subdomain in favor to `verify` subdomain. **(breaking change)**
+
+**Serverless**
+- Add UI-Editable field to Services
+
+**Supersim**
+- Add `inactive` status for Super SIM which is an alias for `deactivated`
+
+**Taskrouter**
+- Adding value range to `priority` in task endpoint
+
+**Verify**
+- Fix `SendCodeAttempts` type. It's an array of objects instead of a unique object. **(breaking change)**
+
+
+[2020-02-19] Version 5.31.5
+---------------------------
+**Library - Chore**
+- [PR #495](https://github.com/twilio/twilio-ruby/pull/495): bump the rubocop version. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Api**
+- Make call create parameters `async_amd`, `async_amd_status_callback`, and `async_amd_status_callback_method` public
+- Add `trunk_sid` as an optional field to Call resource fetch/read responses
+- Add property `queue_time` to successful response of create, fetch, and update requests for Call
+- Add optional parameter `byoc` to conference participant create.
+
+**Authy**
+- Added support for challenges associated to push factors
+
+**Flex**
+- Adding `ui_dependencies` to Flex Configuration
+
+**Messaging**
+- Deprecate Session API **(breaking change)**
+
+**Numbers**
+- Add Regulations API
+
+**Studio**
+- Add Execution and Step endpoints to v2 API
+- Add webhook_url to Flow response and add new /TestUsers endpoint to v2 API
+
+**Taskrouter**
+- Adding `longest_relative_task_age_in_queue` and `longest_relative_task_sid_in_queue` to TaskQueue Real Time Statistics API.
+- Add `wait_duration_in_queue_until_accepted` aggregations to TaskQueues Cumulative Statistics endpoint
+- Add TaskQueueEnteredDate property to Tasks.
+
+**Video**
+- [Composer] Clarification for the composition hooks creation documentation: one source is mandatory, either the `audio_sources` or the `video_layout`, but one of them has to be provided
+- [Composer] `audio_sources` type on the composer HTTP POST command, changed from `sid[]` to `string[]` **(breaking change)**
+- [Composer] Clarification for the composition creation documentation: one source is mandatory, either the `audio_sources` or the `video_layout`, but one of them has to be provided
+
+
+[2020-02-05] Version 5.31.4
+---------------------------
+**Api**
+- Making content retention and address retention public
+- Update `status` enum for Messages to include 'partially_delivered'
+
+**Authy**
+- Added support for push factors
+
+**Autopilot**
+- Add one new property in Query i.e dialogue_sid
+
+**Verify**
+- Add `SendCodeAttempts` to create verification response.
+
+**Video**
+- Clarification in composition creation documentation: one source is mandatory, either `audio_sources` or `video_layout`, but on of them has to be provided
+
+**Twiml**
+- Add Polly Neural voices.
+
+
+[2020-01-22] Version 5.31.3
+---------------------------
+**Library - Docs**
+- [PR #492](https://github.com/twilio/twilio-ruby/pull/492): baseline all the templated markdown docs. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Library - Chore**
+- [PR #490](https://github.com/twilio/twilio-ruby/pull/490): add support for Ruby 2.7. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Api**
+- Add payments public APIs
+- Add optional parameter `byoc` to call create request.
+
+**Flex**
+- Updating a Flex Flow `creation_on_message` parameter documentation
+
+**Preview**
+-
+- Removed Verify v2 from preview in favor of its own namespace as GA **(breaking change)**
+
+**Studio**
+- Flow definition type update from string to object
+
+**Verify**
+- Add `AppHash` parameter when creating a Verification.
+- Add `DoNotShareWarningEnabled` parameter to the Service resource.
+
+**Twiml**
+- Add `track` attribute to siprec noun.
+- Add attribute `byoc` to `<Number>`
+
+
+[2020-01-08] Version 5.31.2
+---------------------------
+**Library - Chore**
+- [PR #491](https://github.com/twilio/twilio-ruby/pull/491): upgrade rubocop to 0.79.0. Thanks to [@juampi](https://github.com/juampi)!
+- [PR #489](https://github.com/twilio/twilio-ruby/pull/489): upgrade faraday to 1.0.0. Thanks to [@juampi](https://github.com/juampi)!
+
+**Numbers**
+- Add Regulatory Compliance CRUD APIs
+
+**Studio**
+- Add parameter validation for Studio v2 Flows API
+
+**Twiml**
+- Add support for `speech_model` to `Gather` verb
+
+
+[2019-12-18] Version 5.31.1
+---------------------------
+**Library - Chore**
+- [PR #488](https://github.com/twilio/twilio-ruby/pull/488): upgrade rubocop to 0.77.0. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Preview**
+- Add `/Insights/SuccessRate` endpoint for Businesses Branded Calls (Verified by Twilio)
+
+**Studio**
+- StudioV2 API in beta
+
+**Verify**
+- Add `MailerSid` property to Verify Service resource.
+
+**Wireless**
+- Added `data_limit_strategy` to Rate Plan resource.
+
+
+[2019-12-12] Version 5.31.0
+---------------------------
+**Api**
+- Make `twiml` conditional for create. One of `url`, `twiml`, or `application_sid` is now required.
+- Add `bundle_sid` parameter to /IncomingPhoneNumbers API
+- Removed discard / obfuscate parameters from ContentRetention, AddressRetention **(breaking change)**
+
+**Chat**
+- Added `last_consumed_message_index` and `last_consumption_timestamp` parameters in update method for UserChannel resource **(breaking change)**
+
+**Conversations**
+- Add Participant SID to Message properties
+
+**Messaging**
+- Fix incorrectly typed capabilities property for ShortCodes. **(breaking change)**
+
+
+[2019-12-04] Version 5.30.0
+---------------------------
+**Library**
+- [PR #485](https://github.com/twilio/twilio-ruby/pull/485): docs: add supported language versions to README. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #445](https://github.com/twilio/twilio-ruby/pull/445): fix: handle building the HTTP client proxy URI without authentication. Thanks to [@laka3000](https://github.com/laka3000)!
+
+**Api**
+- Add optional `twiml` parameter for call create
+
+**Chat**
+- Added `delete` method in UserChannel resource
+
+**Conversations**
+- Allow Messaging Service update
+
+**Taskrouter**
+- Support ReEvaluateTasks parameter on Workflow update
+
+**Twiml**
+- Remove unsupported `mixed_track` value from `<Stream>` **(breaking change)**
+- Add missing fax `<Receive>` optional attributes
+
+
+[2019-11-13] Version 5.29.1
+---------------------------
+**Api**
+- Make `persistent_action` parameter public
+- Add `twiml` optional private parameter for call create
+
+**Autopilot**
+- Add Export resource to Autopilot Assistant.
+
+**Flex**
+- Added Integration.RetryCount attribute to Flex Flow
+- Updating a Flex Flow `channel_type` options documentation
+
+**Insights**
+- Added edges to events and metrics
+- Added new endpoint definitions for Events and Metrics
+
+**Messaging**
+- **create** support for sender registration
+- **fetch** support for fetching a sender
+- **update** support for sender verification
+
+**Supersim**
+- Add `Direction` filter parameter to list commands endpoint
+- Allow filtering commands list by Sim Unique Name
+- Add `Iccid` filter parameter to list sims endpoint
+
+**Twiml**
+- Add support for `<Refer>` verb
+
+
+[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 main. 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**
+- [PR #476](https://github.com/twilio/twilio-ruby/pull/476): Update a few property types in the lookups and trunking responses. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #477](https://github.com/twilio/twilio-ruby/pull/477): Update instance property ordering. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #475](https://github.com/twilio/twilio-ruby/pull/475): Update the call price to be optional for deserializing. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #474](https://github.com/twilio/twilio-ruby/pull/474): breaking: Correct video composition date types. Thanks to [@childish-sambino](https://github.com/childish-sambino)! **(breaking change)**
+
+**Api**
+- Add new property `attempt` to sms_messages
+- Fixed a typo in the documentation for Feedback outcome enum **(breaking change)**
+- Update the call price to be optional for deserializing **(breaking change)**
+
+**Flex**
+- Added `JanitorEnabled` attribute to Flex Flow
+- Change `features_enabled` Flex Configuration key to private **(breaking change)**
+
+**Supersim**
+- Add Fetch endpoint to Fleets resource for Super Sim Pilot
+- Allow assigning a Sim to a Fleet for Super Sim Pilot
+- Add Create endpoint to Fleets resource for Super Sim Pilot
+
+**Twiml**
+- Update `<Conference>` rename "whisper" attribute to "coach" **(breaking change)**
+
+
+[2019-10-02] Version 5.27.1
+---------------------------
+**Library**
+- [PR #473](https://github.com/twilio/twilio-ruby/pull/473): Wrap any Faraday error as a TwilioError. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #472](https://github.com/twilio/twilio-ruby/pull/472): Fix the Dockerfile to use the latest Ruby 2.4 and ignore the Gem lock file. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Conversations**
+- Add media to Conversations Message resource
+
+**Supersim**
+- Add List endpoint to Sims resource for Super Sim Pilot
+
+
+[2019-09-18] Version 5.27.0
+----------------------------
+**Library**
+- [PR #470](https://github.com/twilio/twilio-ruby/pull/470): breaking: Catch and wrap Faraday client errors. Thanks to [@childish-sambino](https://github.com/childish-sambino)! **(breaking change)**
+- [PR #471](https://github.com/twilio/twilio-ruby/pull/471): Drop support for Ruby < 2.4 and add 2.6. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #468](https://github.com/twilio/twilio-ruby/pull/468): Add URI encoding for phone numbers. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #469](https://github.com/twilio/twilio-ruby/pull/469): Add TwiML FaxResponse require to top-level file. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #450](https://github.com/twilio/twilio-ruby/pull/450): Update encode64 to strict_encode64 in RequestValidator#build_signature_for. Thanks to [@kitallis](https://github.com/kitallis)!
+- [PR #467](https://github.com/twilio/twilio-ruby/pull/467): Add a global configuration for the HTTP client. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #466](https://github.com/twilio/twilio-ruby/pull/466): Use the 'base_url' instead of the 'host' for HTTP client URL. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Numbers**
+- Add v2 of the Identites API
+
+**Preview**
+- Changed authentication method for SDK Trusted Comms endpoints: `/CPS`, `/CurrentCall`, and `/Devices`. Please use `Authorization: Bearer <xCNAM JWT>` **(breaking change)**
+
+**Voice**
+- Add Recordings endpoints
+
+
+[2019-09-04] Version 5.26.0
+----------------------------
+**Library**
+- [PR #463](https://github.com/twilio/twilio-ruby/pull/463): Reduce line length to satisfy rubocop constraints. Thanks to [@igracia](https://github.com/igracia)!
+- [PR #399](https://github.com/twilio/twilio-ruby/pull/399): breaking: Added proxy protocol to HTTP Client constructor. Thanks to [@po5i](https://github.com/po5i)! **(breaking change)**
+- [PR #462](https://github.com/twilio/twilio-ruby/pull/462): Correct 'delete' method doc to indicate 'false' when resource not deleted. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #441](https://github.com/twilio/twilio-ruby/pull/441): Link to actual documentation. Thanks to [@alexford](https://github.com/alexford)!
+
+**Api**
+-  Pass Twiml in call update request
+
+**Conversations**
+- Add attributes to Conversations resources
+
+**Flex**
+- Adding `features_enabled` and `serverless_service_sids` to Flex Configuration
+
+**Messaging**
+- Message API required params updated **(breaking change)**
+
+**Preview**
+- Added support for the optional `CallSid` to `/BrandedCalls` endpoint
+
+
+[2019-08-21] Version 5.25.4
+----------------------------
+**Library**
+- [PR #460](https://github.com/twilio/twilio-ruby/pull/460): Update the IP messaging domain name to be 'chat'. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #458](https://github.com/twilio/twilio-ruby/pull/458): Update TwiML docs for naming overrides. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Conversations**
+- Add Chat Conversation SID to conversation default output properties
+
+**Flex**
+- Adding `outbound_call_flows` object to Flex Configuration
+- Adding read and fetch to channels API
+
+**Supersim**
+- Add Sims and Commands resources for the Super Sim Pilot
+
+**Sync**
+- Added configuration option for enabling webhooks from REST.
+
+**Wireless**
+- Added `usage_notification_method` and `usage_notification_url` properties to `rate_plan`.
+
+**Twiml**
+- Add support for `ach-debit` transactions in `Pay` verb
+
+
+[2019-08-05] Version 5.25.3
+----------------------------
+**Preview**
+- Added support for the header `Twilio-Sandbox-Mode` to mock all Voice dependencies
+
+**Twiml**
+- Add support for `<Siprec>` noun
+- Add support for `<Stream>` noun
+- Create verbs `<Start>` and `<Stop>`
+
+
+[2019-07-24] Version 5.25.2
+----------------------------
+**Insights**
+- Added `properties` to summary.
+
+**Preview**
+- Added endpoint to brand a call without initiating it, so it can be initiated manually by the Customer
+
+**Twiml**
+- Update `<Conference>` recording events **(breaking change)**
+
+
+[2019-07-10] Version 5.25.1
+----------------------------
+**Api**
+- Make `friendly_name` optional for applications create
+- Add new property `as_of` date to Usage Record API calls
+
+**Wireless**
+- Added Usage Records resource.
+
+
+[2019-06-26] Version 5.25.0
+----------------------------
+**Autopilot**
+- Adds two new properties in Assistant i.e needs_model_build and development_stage
+
+**Preview**
+- Changed phone numbers from _URL|Path_ to `X-XCNAM-Sensitive` headers **(breaking change)**
+
+**Verify**
+- Add `MessagingConfiguration` resource to verify service
+
+
+[2019-06-12] Version 5.24.0
+----------------------------
+**Autopilot**
+- Add Webhooks resource to Autopilot Assistant.
+
+**Flex**
+- Added missing 'custom' type to Flex Flow
+- Adding `integrations` to Flex Configuration
+
+**Insights**
+- Added attributes to summary.
+
+**Messaging**
+- Message API Create updated with conditional params **(breaking change)**
+
+**Proxy**
+- Document that Proxy will return a maximum of 100 records for read/list endpoints **(breaking change)**
+- Remove non-updatable property parameters for Session update (mode, participants) **(breaking change)**
+
+**Sync**
+- Added reachability debouncing configuration options.
+
+**Verify**
+- Add `RateLimits` and `Buckets` resources to Verify Services
+- Add `RateLimits` optional parameter on `Verification` creation.
+
+**Twiml**
+- Fix `<Room>` participantIdentity casing
+
+
+[2019-05-29] Version 5.23.1
+----------------------------
+**Verify**
+- Add `approved` to status enum
+
+
+[2019-05-15] Version 5.23.0
+----------------------------
+**Api**
+- Make `method` optional for queue members update
+
+**Chat**
+- Removed `webhook.*.format` update parameters in Service resource from public library visibility in v1 **(breaking change)**
+
+**Insights**
+- Added client metrics as sdk_edge to summary.
+- Added optional query param processing_state.
+
+**Numbers**
+- Add addtional metadata fields on a Document
+- Add status callback fields and parameters
+
+**Taskrouter**
+- Added `channel_optimized_routing` attribute to task-channel endpoint
+
+**Video**
+- [Rooms] Add Video Subscription API
+
+**Wireless**
+- Added `imei` to Data Session resource.
+- Remove `imeisv` from Data Session resource. **(breaking change)**
+
+
+[2019-05-01] Version 5.22.3
+----------------------------
+**Serverless**
+- Documentation
+
+**Wireless**
+- Added `imeisv` to Data Session resource.
+
+
+[2019-04-24] Version 5.22.2
+----------------------------
+**Api**
+- Add `verified` property to Addresses
+
+**Numbers**
+- Add API for Identites and documents
+
+**Proxy**
+- Add in use count on number instance
+
+
+[2019-04-12] Version 5.22.1
+----------------------------
+**Flex**
+- Adding PluginService to Flex Configuration
+
+**Numbers**
+- Add API for Proof of Addresses
+
+**Proxy**
+- Clarify documentation for Service and Session fetch
+
+**Serverless**
+- Serverless scaffolding
+
+
+[2019-03-28] Version 5.22.0
+----------------------------
+**Api**
+- Remove optional `if_machine` call create parameter from helper libraries **(breaking change)**
+- Changed `call_sid` path parameter type on QueueMember fetch and update requests **(breaking change)**
+
+**Voice**
+- changed file names to dialing_permissions prefix **(breaking change)**
+
+**Wireless**
+- Added `ResetStatus` property to Sim resource to allow resetting connectivity via the API.
+
+
+[2019-03-15] Version 5.21.2
+----------------------------
+**Library**
+- PR #444: Add Help Center and Support Ticket links to the README. Thanks to @childish-sambino!
+
+**Api**
+- Add `machine_detection_speech_threshold`, `machine_detection_speech_end_threshold`, `machine_detection_silence_timeout` optional params to Call create request
+
+**Flex**
+- Adding Flex Channel Orchestration
+- Adding Flex Flow
+
+
+[2019-03-06] Version 5.21.1
+----------------------------
+**Twiml**
+- Add `de1` to `<Conference>` regions
+
+
+[2019-03-01] Version 5.21.0
+----------------------------
+**Api**
+- Make conference participant preview parameters public
+
+**Authy**
+- Added support for FactorType and FactorStrength for Factors and Challenges
+
+**Iam**
+- First public release
+
+**Verify**
+- Add endpoint to update/cancel a Verification **(breaking change)**
+
+**Video**
+- [Composer] Make RoomSid mandatory **(breaking change)**
+- [Composer] Add `enqueued` state to Composition
+
+**Twiml**
+- Update message body to not be required for TwiML `Dial` noun.
+
+
+[2019-02-15] Version 5.20.1
+----------------------------
+**Library**
+- PR #438: Add a Ruby inspect method to Context classes. Thanks to @childish-sambino!
+
+**Api**
+- Add `force_opt_in` optional param to Messages create request
+- Add agent conference category to usage records
+
+**Flex**
+- First public release
+
+**Taskrouter**
+- Adding `reject_pending_reservations` to worker update endpoint
+- Added `event_date_ms` and `worker_time_in_previous_activity_ms` to Events API response
+- Add ability to filter events by TaskChannel
+
+**Verify**
+- Add `EnablePsd2` optional parameter for PSD2 on Service resource creation or update.
+- Add `Amount`, `Payee` optional parameters for PSD2.
+
+
+[2019-02-04] Version 5.20.0
+----------------------------
+**Library**
+- PR #437: Switch body validator to use hex instead of base64. Thanks to @cjcodes!
+
+**Video**
+- [Recordings] Add media type filter to list operation
+- [Composer] Filter Composition Hook resources by FriendlyName
+
+**Twiml**
+- Update `language` enum for `Gather` to fix language code for Filipino (Philippines) and include additional supported languages **(breaking change)**
 
-Version 4.6.2
--------------
 
-Release November 19, 2015
+[2019-01-11] Version 5.19.0
+----------------------------
+**Library**
+- PR #436: Remove jruby-openssl requirement. Thanks to @philnash!
 
-- Fix Pricing Messages
+**Chat**
+- Mark Member attributes as PII
 
-Version 4.6.1
+**Insights**
+- Initial revision.
+
+**Proxy**
+- Remove unsupported query parameters **(breaking change)**
+- Remove invalid session statuses in doc
+
+**Verify**
+- Add `lookup` information in the response when creating a new verification (depends on the LookupEnabled flag being enabled at the service level)
+- Add `VerificationSid` optional parameter on Verification check.
+
+
+[2018-12-17] Version 5.18.0
+----------------------------
+**Authy**
+- Reverted the change to `FactorType` and `FormType`, avoiding conflicts with Helper Libraries reserved words (`type`) **(breaking change)**
+
+**Proxy**
+- Remove incorrect parameter for Session List
+
+**Studio**
+- Support date created filtering on list of executions
+
+**Taskrouter**
+- Adding ability to Create, Modify and Delete Task Channels.
+
+**Verify**
+- Add `SkipSmsToLandlines`, `TtsName`, `DtmfInputRequired` optional parameters on Service resource creation or update.
+
+**Wireless**
+- Added delete action on Command resource.
+- Added delete action on Sim resource.
+
+**Twiml**
+- Change `currency` from enum to string for `Pay` **(breaking change)**
+
+
+[2018-11-30] Version 5.17.0
+----------------------------
+**Api**
+- Add `interactive_data` optional param to Messages create request
+
+**Authy**
+- Required authentication for `/v1/Forms/{type}` endpoint **(breaking change)**
+- Removed `Challenge.reason` to `Challenge.responded_reason`
+- Removed `verification_sid` from Challenge responses
+- Removed `config` param from the Factor creation
+- Replaced all occurrences of `FactorType` and `FormType` in favor of a unified `Type` **(breaking change)**
+
+**Chat**
+- Add Member attributes
+
+**Preview**
+- Removed `Authy` version from `preview` subdomain in favor to `authy` subdomain. **(breaking change)**
+
+**Verify**
+- Add `CustomCode` optional parameter on Verication creation.
+
+
+[2018-11-16] Version 5.16.0
+----------------------------
+**Messaging**
+- Session API
+
+**Twiml**
+- Change `master-card` to `mastercard` as `cardType` for `Pay` and `Prompt`, remove attribute `credential_sid` from `Pay` **(breaking change)**
+
+
+[2018-10-29] Version 5.15.2
+----------------------------
+**Api**
+- Add new Balance resource:
+    - url: '/v1/Accounts/{account sid}/Balance'
+    - supported methods: GET
+    - returns the balance of the account
+
+**Proxy**
+- Add chat_instance_sid to Service
+
+**Verify**
+- Add `Locale` optional parameter on Verification creation.
+
+
+[2018-10-15] Version 5.15.1
+----------------------------
+**Api**
+- Add <Pay> Verb Transactions category to usage records
+
+**Twiml**
+- Add support for `Pay` verb
+
+
+[2018-10-15] Version 5.15.0
+----------------------------
+**Library**
+- PR #428: Fix custom param tests. Thanks to @ryan-rowland!
+
+**Api**
+- Add `coaching` and `call_sid_to_coach` to participant properties, create and update requests.
+
+**Authy**
+- Set public library visibility, and added PII stanza
+- Dropped support for `FactorType` param given new Factor prefixes **(breaking change)**
+- Supported `DELETE` actions for Authy resources
+- Move Authy Services resources to `authy` subdomain
+
+**Autopilot**
+- Introduce `autopilot` subdomain with all resources from `preview.understand`
+
+**Preview**
+- Renamed Understand intent to task **(breaking change)**
+- Deprecated Authy endpoints from `preview` to `authy` subdomain
+
+**Taskrouter**
+- Allow TaskQueue ReservationActivitySid and AssignmentActivitySid to not be configured for MultiTask Workspaces
+
+**Verify**
+- Add `LookupEnabled` optional parameter on Service resource creation or update.
+- Add `SendDigits` optional parameter on Verification creation.
+- Add delete action on Service resourse.
+
+**Twiml**
+- Add custom parameters to TwiML `Client` noun and renamed the optional `name` field to `identity`. This is a breaking change in Ruby, and applications will need to transition from `dial.client ''` and `dial.client 'alice'` formats to `dial.client` and `dial.client(identity: alice)` formats. **(breaking change)**
+
+
+[2018-10-04] Version 5.14.1
+----------------------------
+**Twiml**
+- Add `debug` to `Gather`
+- Add `participantIdentity` to `Room`
+
+
+[2018-09-28] Version 5.14.0
+----------------------------
+**Api**
+- Set `call_sid_to_coach` parameter in participant to be `preview`
+
+**Preview**
+- Renamed response headers for Challenge and Factors Signatures
+- Supported `totp` in Authy preview endpoints
+- Allowed `latest` in Authy Challenges endpoints
+
+**Video**
+- [Composer] Add Composition Hook resources
+
+**Voice**
+- changed path param name from parent_iso_code to iso_code for highrisk_special_prefixes api **(breaking change)**
+- added geo permissions public api
+
+
+[2018-09-20] Version 5.13.0
+----------------------------
+**Preview**
+- Add `Form` resource to Authy preview given a `form_type`
+- Add Authy initial api-definitions in the 4 main resources: Services, Entities, Factors, Challenges
+
+**Pricing**
+- add voice_numbers resource (v2)
+
+**Verify**
+- Move from preview to beta **(breaking change)**
+
+
+[2018-08-31] Version 5.12.4
+----------------------------
+**Library**
+- PR #427: VCORE-3651 Add support for *for* attribute in twiml element. Thanks to @nmahure!
+
+**Api**
+- Add `call_sid_to_coach` parameter to participant create request
+- Add `voice_receive_mode` param to IncomingPhoneNumbers create
+
+**Video**
+- [Recordings] Expose `offset` property in resource
+
+
+[2018-08-23] Version 5.12.3
+----------------------------
+**Chat**
+- Add User Channel instance resource
+
+
+[2018-08-17] Version 5.12.2
+----------------------------
+**Api**
+- Add Proxy Active Sessions category to usage records
+
+**Preview**
+- Add `Actions` endpoints and remove `ResponseUrl` from assistants on the Understand api
+
+**Pricing**
+- add voice_country resource (v2)
+
+
+[2018-08-09] Version 5.12.1
+----------------------------
+**Library**
+- PR #426: Add a test showing how to emit "interpret-as". Thanks to @ekarson!
+
+**Studio**
+- Studio is now GA
+
+
+[2018-08-03] Version 5.12.0
+----------------------------
+**Library**
+- PR #420: Tag and push Docker latest image when deploying with TravisCI. Thanks to @jonatasbaldin!
+
+**Chat**
+- Make message From field updatable
+- Add REST API webhooks
+
+**Notify**
+- Removing deprecated `segments`, `users`, `segment_memberships`, `user_bindings` classes from helper libraries. **(breaking change)**
+
+**Preview**
+- Add new Intent Statistics endpoint
+- Remove `ttl` from Assistants
+
+**Twiml**
+- Add `Connect` and `Room` for Programmable Video Rooms
+
+
+[2018-07-26] Version 5.11.2
+----------------------------
+**Library**
+- PR #424: Fix Say example in README.md. Thanks to @HuipengRen!
+
+**Api**
+- Add support for sip domains to map credential lists for registrations
+
+**Preview**
+- Remove `ttl` from Assistants
+
+**Proxy**
+- Enable setting a proxy number as reserved
+
+**Twiml**
+- Add support for SSML lang tag on Say verb
+
+
+[2018-07-17] Version 5.11.1
+----------------------------
+**Library**
+- PR #422: Add attribute overrides from generated code. Thanks to @cjcodes!
+
+**Video**
+- Add `group-small` room type
+
+
+[2018-07-16] Version 5.11.0
+----------------------------
+**Library**
+- PR #421: Fix TwiML Say verb spec. Thanks to @HuipengRen!
+- PR #419: Add a request body validator. Thanks to @cjcodes!
+- PR #418: Remove support for ruby 2.0 and 2.1, adds 2.5. Thanks to @cjcodes!
+
+**Twiml**
+- Add support for SSML on Say verb, the message body is changed to be optional **(breaking change)**
+
+
+[2018-07-11] Version 5.10.7
+----------------------------
+**Api**
+- Add `cidr_prefix_length` param to SIP IpAddresses API
+
+**Studio**
+- Add new /Execution endpoints to begin Engagement -> Execution migration
+
+**Video**
+- [Rooms] Allow deletion of individual recordings from a room
+
+
+[2018-07-05] Version 5.10.6
+----------------------------
+**Library**
+- PR #413: Add Dockerfile and related changes to build the Docker image. Thanks to @jonatasbaldin!
+
+**Api**
+- Release `Call Recording Controls` feature support in helper libraries
+- Add Voice Insights sub-category keys to usage records
+
+
+[2018-06-21] Version 5.10.5
+----------------------------
+**Library**
+- PR #414: Added test for mixed content. Thanks to @ekarson!
+
+**Video**
+- Allow user to set `ContentDisposition` when obtaining media URLs for Room Recordings and Compositions
+- Add Composition Settings resource
+
+
+[2018-06-19] Version 5.10.4
+----------------------------
+**Library**
+- PR #412: Allow adding TwiML children with generic tag names. Thanks to @ekarson!
+- PR #408: Add validate_ssl_certificate helper method to Client. Thanks to @ekarson!
+- PR #410: Allow adding text nodes to TwiML responses. Thanks to @ekarson!
+
+**Api**
+- Add Fraud Lookups category to usage records
+
+**Twiml**
+- Add methods to helper libraries to inject arbitrary text under a TwiML node
+
+
+[2018-06-04] Version 5.10.3
+----------------------------
+**Library**
+- PR #409: Switch to single quotes for rubocop. Thanks to @cjcodes!
+- PR #407: Allows developers to add comments to TwiML. Thanks to @philnash!
+- PR #405: Update description. Thanks to @efossier!
+
+**Chat**
+- Add Binding and UserBinding documentation
+
+**Lookups**
+- Add back support for `fraud` lookup type
+
+
+[2018-05-25] Version 5.10.2
+----------------------------
+**Studio**
+- Add endpoint to delete engagements
+
+
+[2018-05-18] Version 5.10.1
+----------------------------
+**Api**
+- Add more programmable video categories to usage records
+- Add 'include_subaccounts' parameter to all variation of usage_record fetch
+
+**Trunking**
+- Added cnam_lookup_enabled parameter to Trunk resource.
+- Added case-insensitivity for recording parameter to Trunk resource.
+
+
+[2018-05-11] Version 5.10.0
+----------------------------
+**Chat**
+- Add Channel Webhooks resource
+
+**Monitor**
+- Update event filtering to support date/time **(breaking change)**
+
+**Wireless**
+- Updated `maturity` to `ga` for all wireless apis
+
+
+[2018-04-27] Version 5.9.0
+---------------------------
+**Library**
+- PR #403: Adds frozen_string_literal magic comment. Thanks to @philnash!
+
+**Video**
+- Redesign API by adding custom `VideoLayout` object. **(breaking change)**
+
+
+[2018-04-20] Version 5.8.1
+---------------------------
+**Library**
+- PR #397: Uses Twilio::REST::RestError when a page fails to load. Thanks to @philnash!
+
+**Twiml**
+- Gather input Enum: remove unnecessary "dtmf speech" value as you can now specify multiple enum values for this parameter and both "dtmf" and "speech" are already available.
+
+
+[2018-04-13] Version 5.8.0
+---------------------------
+**Library**
+- PR #389: Add incoming.allow to AccessToken VoiceGrant. Thanks to @ryan-rowland!
+- PR #391: Improves error message for Twilio::REST::RestError. Thanks to @philnash!
+
+**Lookups**
+- Disable support for `fraud` lookups **(breaking change)**
+
+**Preview**
+- Support for Understand V2 APIs - renames various resources and adds new fields
+
+**Studio**
+- Change parameters type from string to object in engagement resource
+
+**Video**
+- [Recordings] Change `size` type to `long`. **(breaking change)**
+
+
+[2018-03-22] Version 5.7.2
+---------------------------
+**Preview**
+- Add `BuildDuration` and `ErrorCode` to Understand ModelBuild
+
+**Studio**
+- Add new /Context endpoint for step and engagement resources.
+
+
+[2018-03-09] Version 5.7.1
+---------------------------
+**Api**
+- Add `caller_id` param to Outbound Calls API
+- Release `trim` recording Outbound Calls API functionality in helper libraries
+
+**Video**
+- Add `room_sid` to Composition resource.
+
+**Twiml**
+- Adds support for passing in multiple input type enums when setting `input` on `Gather`
+
+
+[2018-03-02] Version 5.7.0
+---------------------------
+**TwiML**
+- Allow newlines in TwiML content. Better XML configuration in general.
+
+**Studio**
+- Add new /Context endpoint for step and engagement resources. Removes the context property from existing step and engagement resources. *(breaking change)*
+
+
+[2018-02-23] Version 5.6.4
+---------------------------
+**Library**
+- PR #385 - Fix ClientCapability appParams
+
+**Api**
+- Add `trim` param to Outbound Calls API
+
+**Lookups**
+- Add support for `fraud` lookup type
+
+**Numbers**
+- Initial Release
+
+**Video**
+- [composer] Add `SEQUENCE` value to available layouts, and `trim` and `reuse` params.
+
+
+[2018-02-09] Version 5.6.3
+---------------------------
+**Api**
+- Add `AnnounceUrl` and `AnnounceMethod` params for conference announce
+
+**Chat**
+- Add support to looking up user channels by identity in v1
+
+
+[2018-01-30] Version 5.6.2
+---------------------------
+**Api**
+- Add `studio-engagements` usage key
+
+**Preview**
+- Remove Studio Engagement Deletion
+
+**Studio**
+- Initial Release
+
+**Video**
+- [omit] Beta: Allow updates to `SubscribedTracks`.
+- Add `SubscribedTracks`.
+- Add track name to Video Recording resource
+- Add Composition and Composition Media resources
+
+
+[2018-01-22] Version 5.6.1
+---------------------------
+**Api**
+- Add `conference_sid` property on Recordings
+- Add proxy and sms usage key
+
+**Chat**
+- Make user channels accessible by identity
+- Add notifications logs flag parameter
+
+**Fax**
+- Added `ttl` parameter
+  `ttl` is the number of minutes a fax is considered valid.
+
+**Preview**
+- Add `call_delay`, `extension`, `verification_code`, and `verification_call_sids`.
+- Add `failure_reason` to HostedNumberOrders.
+- Add DependentHostedNumberOrders endpoint for AuthorizationDocuments preview API.
+
+
+[2017-12-15] Version 5.6.0
+---------------------------
+**Api**
+- Add `voip`, `national`, `shared_cost`, and `machine_to_machine` sub-resources to `/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountryCode}/`
+- Add programmable video keys
+
+**Preview**
+- Add `verification_type` and `verification_document_sid` to HostedNumberOrders.
+
+**Proxy**
+- Fixed typo in session status enum value
+
+**Twiml**
+- Fix Dial record property incorrectly typed as accepting TrimEnum values when it actually has its own enum of values. *(breaking change)*
+- Add `priority` and `timeout` properties to Task TwiML.
+- Add support for `recording_status_callback_event` for Dial verb and for Conference
+
+
+[2017-12-01] Version 5.5.1
+---------------------------
+**Api**
+- Use the correct properties for Dependent Phone Numbers of an Address *(breaking change)*
+- Update Call Recordings with the correct properties
+
+**Preview**
+- Add `status` and `email` query param filters for AuthorizationDocument list endpoint
+
+**Proxy**
+- Added DELETE support to Interaction
+- Standardized enum values to dash-case
+- Rename Service#friendly_name to Service#unique_name
+
+**Video**
+- Remove beta flag from `media_region` and `video_codecs`
+
+**Wireless**
+- Bug fix: Changed `operator_mcc` and `operator_mnc` in `DataSessions` subresource from `integer` to `string`
+
+
+[2017-11-17] Version 5.5.0
+---------------------------
+**Sync**
+- Add TTL support for Sync objects *(breaking change)*
+  - The required `data` parameter on the following actions is now optional: "Update Document", "Update Map Item", "Update List Item"
+  - New actions available for updating TTL of Sync objects: "Update List", "Update Map", "Update Stream"
+
+**Video**
+- [bi] Rename `RoomParticipant` to `Participant`
+- Add Recording Settings resource
+- Expose EncryptionKey and MediaExternalLocation properties in Recording resource
+
+
+[2017-11-10] Version 5.4.5
+---------------------------
+**Accounts**
+- Add AWS credential type
+
+**Preview**
+- Removed `iso_country` as required field for creating a HostedNumberOrder.
+
+**Proxy**
+- Added new fields to Service: geo_match_level, number_selection_behavior, intercept_callback_url, out_of_session_callback_url
+
+
+[2017-11-03] Version 5.4.4
+---------------------------
+**Library**
+- PR #365: Fixed proxy interpolation. Thanks @ankane.
+
+**Api**
+- Add programmable video keys
+
+**Video**
+- Add `Participants`
+
+
+[2017-10-27] Version 5.4.3
+---------------------------
+**Chat**
+- Add Binding resource
+- Add UserBinding resource
+
+
+[2017-10-20] Version 5.4.2
+---------------------------
+**Library**
+- #360 Fix downcasing twiml parameters that are not snake_case
+
+[2017-10-20] Version 5.4.1
+---------------------------
+**Library**
+- #359 Correctly set headers on Twilio::Response
+
+**Api**
+- Add `address_sid` param to IncomingPhoneNumbers create and update
+- Add 'fax_enabled' option for Phone Number Search
+
+
+[2017-10-13] Version 5.4.0
+---------------------------
+**Api**
+- Add `smart_encoded` param for Messages
+- Add `identity_sid` param to IncomingPhoneNumbers create and update
+
+**Preview**
+- Make 'address_sid' and 'email' optional fields when creating a HostedNumberOrder
+- Add AuthorizationDocuments preview API.
+
+**Proxy**
+- Initial Release
+
+**Wireless**
+- Added `ip_address` to sim resource
+
+
+[2017-10-06] Version 5.3.1
+---------------------------
+**Preview**
+- Add `acc_security` (authy-phone-verification) initial api-definitions
+
+**Taskrouter**
+- [bi] Less verbose naming of cumulative and real time statistics
+
+
+[2017-09-29] Version 5.3.0
+---------------------------
+**Library**
+- Remove left over files from legacy 4.x library
+
+**Chat**
+- Make member accessible through identity
+- Make channel subresources accessible by channel unique name
+- Set get list 'max_page_size' parameter to 100
+- Add service instance webhook retry configuration
+- Add media message capability
+- Make `body` an optional parameter on Message creation. *(breaking change)*
+
+**Notify**
+- `data`, `apn`, `gcm`, `fcm`, `sms` parameters in `Notifications` create resource now accept objects (hashes) instead of strings. Passing manually stringified json will continue to work.
+
+**Taskrouter**
+- Add new query ability by TaskChannelSid or TaskChannelUniqueName
+- Move Events, Worker, Workers endpoint over to CPR
+- Add new RealTime and Cumulative Statistics endpoints
+
+**Video**
+- Create should allow an array of video_codecs.
+- Add video_codecs as a property of room to make it externally visible.
+
+
+[2017-09-15] Version 5.2.3
+---------------------------
+**Api**
+- Add `sip_registration` property on SIP Domains
+- Add new video and market usage category keys
+- Add support for transferring IncomingPhoneNumbers between accounts.
+
+
+[2017-09-08] Version 5.2.2
+---------------------------
+- Add configurable timeout to HttpClient
+
+[2017-09-01] Version 5.2.1
+---------------------------
+**Sync**
+- Add support for Streams
+
+**Wireless**
+- Added DataSessions sub-resource to Sims.
+
+
+[2017-08-25] Version 5.2.0
+---------------------------
+**Library**
+- Add `last_request`, `last_response` properties to http client for easier debugging.
+- Add `Request` class to abstract http client implementations.
+- Rename `TwilioResponse` to `Response` for consistency, deprecate `TwilioResponse` class.
+- Support libxml 2 and 3. Issue #315. Thanks @malmckay.
+- Add `inspect` methods to all classes. Thanks @malmckay.
+
+**Api**
+- Update `status` enum for Recordings to include 'failed'
+- Add `error_code` property on Recordings
+
+**Chat**
+- Add mutable parameters for channel, members and messages
+
+**Video**
+- New `media_region` parameter when creating a room, which controls which region media will be served out of.
+
+
+[2017-08-18] Version 5.1.2
+---------------------------
+**Api**
+- Add VoiceReceiveMode {'voice', 'fax'} option to IncomingPhoneNumber UPDATE requests
+
+**Chat**
+- Add channel message media information
+- Add service instance message media information
+
+**Preview**
+- Removed 'email' from bulk_exports configuration api [bi]. No migration plan needed because api has not been used yet.
+- Add DeployedDevices.
+
+**Sync**
+- Add support for Service Instance unique names
+
+
+[2017-08-10] Version 5.1.1
+---------------------------
+**Library**
+- Don't override Faraday default param encoder. Thanks to @isaacseymour. PR #309
+- Fix incorrectly aliased `to_xml` on TwiML classes. Thanks to @philnash. PR #318
+- Only define `to_s` on BaseJWT instead of subclasses. Thanks to @philnash. PR #321
+- Silence deprecation messages in testing. Thanks to @philnash. PR #323
+
+**Api**
+- Add New wireless usage keys added
+- Add `auto_correct_address` param for Addresses create and update
+
+**Video**
+- Add `video_codec` enum and `video_codecs` parameter, which can be set to either `VP8` or `H264` during room creation.
+- Restrict recordings page size to 100
+
+**Chat**
+- Add ChatGrant to available access tokens.
+- Mark IpMessagingGrant as deprecated in favor of ChatGrant.
+
+
+[2017-07-27] Version 5.1.0
+---------------------------
+This release adds Beta and Preview products to main artifact.
+
+Previously, Beta and Preview products were only included in the alpha artifact.
+They are now being included in the main artifact to ease product
+discoverability and the collective operational overhead of maintaining multiple
+artifacts per library.
+
+**Api**
+- Remove unused `encryption_type` property on Recordings *(breaking change)*
+- Update `status` enum for Messages to include 'accepted'
+- Update `AnnounceMethod` parameter naming for consistency
+
+**Messaging**
+- Fix incorrectly typed capabilities property for PhoneNumbers.
+
+**Notify**
+- Add `ToBinding` optional parameter on Notifications resource creation. Accepted values are json strings.
+
+**Preview**
+- Add `sms_application_sid` to HostedNumberOrders.
+- Add `verification_attempts` to HostedNumberOrders.
+
+**Taskrouter**
+- Fully support conference functionality in reservations.
+
+
+[2017-07-13] Version 5.0.0
+--------------------------------
+- Moving to General Availability
+
+[2017-07-07] Version 5.0.0.rc26
+--------------------------------
+**Api**
+- [omit] Rachet /Keys and /SigningKeys
+
+**Preview**
+- Add `status_callback_url` and `status_callback_method` to HostedNumberOrders.
+
+
+[2017-07-06] Version 5.0.0.rc25
+--------------------------------
+**Messaging**
+- Fix incorrectly typed capabilities property for PhoneNumbers.
+
+**Notify**
+- Add `ToBinding` optional parameter on Notifications resource creation. Accepted values are json strings.
+
+**Preview**
+- [omit] Enabled beta feature flag (api.vault.data-platform) for bulk_exports api
+
+**Video**
+- Filter recordings by date using the parameters `DateCreatedAfter` and `DateCreatedBefore`.
+- Override the default time-to-live of a recording's media URL through the `Ttl` parameter (in seconds, default value is 3600).
+- Add query parameters `SourceSid`, `Status`, `DateCreatedAfter` and `DateCreatedBefore` to the convenience method for retrieving Room recordings.
+
+**Wireless**
+- Added national and international data limits to the RatePlans resource.
+
+
+[2017-06-22] Version 5.0.0.rc24
+-------------------------------
+- Namespaced Policy, Grants, and Scope to their respective Token.
+- Added `announce_url` and `annouce_url_method` to Conference update.
+- Added `store_media` to Fax.
+
+[2017-06-19] Version 5.0.0.rc23
+-------------------------------
+- Fixed ClientCapability parameter encoded bug.
+- Optional URL parameter for TwiML Play verb.
+
+[2017-06-15] Version 5.0.0.rc22
+-------------------------------
+- Refactor JWT token constructors
+
+
+[2017-05-24] Version 5.0.0.rc21
+-------------------------------
+- Add HostedNumbers preview support.
+- Add Proxy preview support.
+- Add BulkExports preview support.
+
+[2017-05-22] Version 5.0.0.rc20
+-------------------------------
+- Add Wireless Domain
+- Add Fax Domain
+- Add Video Domain
+- Updated Usage Trigger enums with missing categories.
+- Add `area_code_geomatch`, `validtiy_period`, `fallback_to_long_code` to Messaging Service
+- Converted `TwilioException` to `TwilioError`
+
+[2017-04-27] Version 5.0.0.rc19
+-------------------------------
+
+- Add chat v2.
+- Wireless rate plans updates.
+- Message `ValidityPeriod` parameter.
+- New Usage API categories.
+
+Version 5.0.0.rc18
+-------------------------------
+
+Release April 17, 2017
+
+- Update VideoGrant access token to accept `room` instead of `configuration_profile_sid`
+
+Version 5.0.0.rc16
+-------------------------------
+
+Release September 1, 2016
+
+- Add voice grant.
+
+Version 5.0.0.rc8
 -------------
 
-Release November 10, 2015
+Release July 8, 2016
 
-- Fix TrunkingClient references
+- Add SMS and Facebook Messenger for Notify
 
-Version 4.6.0
+Version 5.0.0.rc7
 -------------
 
-Release October 28, 2015
+Release June 9, 2016
+
+- Add messaging feedback support
 
-- Add /Keys endpoint
 
-Version 4.4.0
+Version 5.0.0.rc5
 -------------
 
-Release September 23, 2015
+Release May 31, 2016
 
-- Add fetching a list of worker reservations
-- Add TaskRouter Workflow builder
+- Add preview.twilio.com/wireless support
 
-Version 4.3.0
+Version 5.0.0.rc4
 -------------
 
-Release August 11, 2015
+Release March 28, 2016
 
-- Add support for new Taskrouter JWT Functionality, JWTs now grant access to
-  - Workspace
-  - Worker
-  - TaskQueue
+- Add notifications.twilio.com subdomain
 
-Version 4.2.1
+Version 5.0.0
 -------------
 
-Release June 19, 2015
+Release January 29, 2016
 
-- Allow passing URL parameters through when getting statistics for TaskRouter objects
-- URI encode phone number lookups
-- Adds documentation for lookups
+- First class paging support
+- Streaming auto-paging functionality
+- Separation between strict paging and streaming, with network-efficient defaults
+- Fully configurable and swappable HTTP Client interfaces
+- Normalization of mounts -> endpoints relations, with first-class unified support for subdomains and multi-version support
+- Fixed URL pathing of subresources, preventing edge case errors with path building via mounting
+- Proper serialization/deserialization of types (integers, dates, etc.)
 
 Version 4.2.0
 -------------