twilio-ruby 7.11.3 → 7.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92782df8271f1b9a7f8ee80b10514048392c27dc6d58c3513e21a8fa2592a74e
-  data.tar.gz: 031343a9310ec971d5d015aaadd5df55ab781a9cacfd15b53dc6bf79b95fae05
+  metadata.gz: de45c2f4e640d77d1ef3ce66c59c270c8c76a7bf60802a5168c0431f72ab3eb1
+  data.tar.gz: 319065808ccb2132bc019d456490657bd25a07adcfa783f1b0815ea01b9e512e
 SHA512:
-  metadata.gz: cdcf4946f4391697754789328369c248036fc05a7217ee4d60a4bad9ef2e61f6e0ec4fbcaddbca51b141d7d771ce1fefc55dcba49bd775af43521b8b73a86e28
-  data.tar.gz: 170130144ac18fbe7dc463683ea7ddea4494ba27fc329f29a801a44f317fb4c19ba9fbeb72d0d506c4c94d50efe239cc46e78c157c425de0200186662a7fbd59
+  metadata.gz: f4eca7472b55d315dcf30b819e04754760fb49250151fb72912db9199502325b910b544464a788277c4aa0974c49872fdba45c6f0af96e52396341d0ce1356c2
+  data.tar.gz: 5c7a1776e780a85d5ecfd9b2b928122baad0cd7ba3ee100cec889ba84a49b68970b38be01f1f72aa491f5fd36e7224cd9e792b5e64986d6eeb09bfe9c04f738a

data/CHANGES.md

@@ -1,5 +1,81 @@
 twilio-ruby changelog
 =====================
+[2026-10-12] Version 7.12.0
+---------------------------
+**Audiences**
+- ## 2026-10-06
+- Minor updates (formatting, metadata)
+- ## 2026-10-05
+- Minor updates (formatting, metadata)
+- ## 2026-10-02
+- **Added 1 new path(s)**:
+- `/preview/Cohorts/{cohortId}/Operations` (AdminListCohortOperations)
+- ## 2026-10-01
+- **Content updates**:
+- Updated description for `AdminListSnapshotOperations`
+- ## 2026-09-28
+- **Content updates**:
+- Updated description for `AdminListCohortSnapshots`
+- Updated description for `AdminFetchCohortSnapshot`
+- Updated schema description for `Criteria`
+- Added properties to `OperationPayload`: cohortId
+- Removed properties from `OperationPayload`: audienceId
+- Updated schema description for `OperationResult`
+- Added properties to `OperationResult`: cohortId
+- Removed properties from `OperationResult`: audienceId
+- Updated schema description for `Record`
+- Updated schema description for `Cohort`
+- ...and 3 more changes
+- ## 2026-10-01
+- Minor updates (formatting, metadata)
+- ## 2026-09-28
+- **Content updates**:
+- Updated schema description for `CohortOperationResult`
+- Updated schema description for `PartitionCount`
+
+**Conversations**
+- Add PATCH /v2/Imports/{id} to cancel an import, and the `CANCELED` import status (dev-us1 and stage-us1)
+- Add Imports endpoints for 1console (private visibility, dev-us1 and stage-us1)
+- Add `traitExtractionStrategyIds` and `observationExtractionStrategyIds` to the Conversations v2 Admin Configuration schema.
+- Align the Conversations v2 Capabilities list and create contracts with the backend `domainId` field.
+
+**Data-ingress**
+- ## 2026-10-01
+- Minor updates (formatting, metadata)
+- ## 2026-09-17
+- Add support for Hubspot connector
+- ## 2026-10-01
+- Minor updates (formatting, metadata)
+- ## 2026-09-17
+- Add support for Hubspot connector
+
+**Events**
+- Remove the Replays API (`/v1/Replays`, beta feature `api.eventstreams.replay`); the feature was never GA and is being sunset **(breaking change)**
+
+**Knowledge**
+- ## 2026-09-24
+- **Routing updates**:
+- Changed `downstreamServiceName` from `memora-domain` to `enterprise-knowledge-domain` for all operations
+
+**Memory**
+- ## 2026-09-30
+- The `source` field on observations and conversation summaries, and the `source` filter
+- on `ListProfileObservations`, now also accept forward slashes (`/`). The pattern is
+- `^[a-zA-Z0-9 _./-]+$`. This is additive and backwards compatible: every previously
+- valid value is still accepted.
+- `UpdateStore`, `UpdateTraitGroup`, and `UpdateDataMapping` now require a body with at least one property. An empty `{}` gets a 400.
+
+**Messaging**
+- Add opt-out configuration admin endpoints (`GET/PUT/DELETE /v1/Accounts/{AccountSid}/OptOuts/{OptOutSid}/...`) to the messaging admin-api (dev-us1 and stage-us1 only)
+- Add create opt-out configuration endpoint (`POST /v1/Accounts/{AccountSid}/OptOuts`) to the messaging admin-api (dev-us1 and stage-us1 only)
+- Add update messaging service endpoint (`PUT /v1/Accounts/{AccountSid}/Services/{MessagingServiceSid}`) to the messaging admin-api (dev-us1 and stage-us1 only)
+- Enable messaging service add-ons, update messaging service, and opt-out configuration admin endpoints in prod-us1 and prod-ie1
+- Add WhatsApp display name change support to Sender API: `pending_display_name`, `pending_display_name_status` and `pending_display_name_status_date` on fetch, and `display_name_status` on update and partial update
+
+**Routes**
+- Set SDK and docs visibility of `GET`/`POST` `/v3/ShortCodes/{isoCountryCode}/{shortCode}` to `public`, maturity to `ga`
+
+
 [2026-09-28] Version 7.11.3
 ---------------------------
 **Library - Fix**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    twilio-ruby (7.11.3)
+    twilio-ruby (7.12.0)
       faraday (>= 2.0, < 3.0)
       jwt (>= 1.5, < 4.0)
       nokogiri (>= 1.6, < 2.0)
@@ -144,7 +144,7 @@ CHECKSUMS
   rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   simplecov (1.0.3) sha256=38ef0514f16ae7562f0d0f4df02610071115103d301b6de7dacbcc000082e39b
-  twilio-ruby (7.11.3)
+  twilio-ruby (7.12.0)
   unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
   unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
   uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6

data/README.md

@@ -39,13 +39,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 7.11.3'
+gem 'twilio-ruby', '~> 7.12.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 7.11.3
+gem install twilio-ruby -v 7.12.0
 ```
 
 To build and install the development branch yourself from the latest source:

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

@@ -45,7 +45,7 @@ module Twilio
                     # @param [Date] date_updated_before Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [Date] date_updated_after Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [String] friendly_name The string that identifies the Conference resources to read.
-                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`.
+                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`. Starting from September 30th, 2026, the default is `in-progress`. To read completed conferences, set `Status` to `completed`.
                     # @param [Integer] limit Upper limit for the number of records to return. stream()
                     #    guarantees to never return more than limit.  Default is no limit
                     # @param [Integer] page_size Number of records to fetch per request, when
@@ -79,7 +79,7 @@ module Twilio
                     # @param [Date] date_updated_before Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [Date] date_updated_after Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [String] friendly_name The string that identifies the Conference resources to read.
-                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`.
+                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`. Starting from September 30th, 2026, the default is `in-progress`. To read completed conferences, set `Status` to `completed`.
                     # @param [Integer] limit Upper limit for the number of records to return. stream()
                     #    guarantees to never return more than limit.  Default is no limit
                     # @param [Integer] page_size Number of records to fetch per request, when
@@ -117,7 +117,7 @@ module Twilio
                       # @param [Date] date_updated_before Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                       # @param [Date] date_updated_after Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                       # @param [String] friendly_name The string that identifies the Conference resources to read.
-                      # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`.
+                      # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`. Starting from September 30th, 2026, the default is `in-progress`. To read completed conferences, set `Status` to `completed`.
                     # @param [Integer] limit Upper limit for the number of records to return. stream()
                     #    guarantees to never return more than limit.  Default is no limit
                     # @param [Integer] page_size Number of records to fetch per request, when
@@ -174,7 +174,7 @@ module Twilio
                     # @param [Date] date_updated_before Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [Date] date_updated_after Only include conferences that were last updated on this date. Specify a date as `YYYY-MM-DD` in UTC, for example: `2009-07-06`, to read only conferences that were last updated on this date. You can also specify an inequality, such as `DateUpdated<=YYYY-MM-DD`, to read conferences that were last updated on or before midnight of this date, and `DateUpdated>=YYYY-MM-DD` to read conferences that were last updated on or after midnight of this date.
                     # @param [String] friendly_name The string that identifies the Conference resources to read.
-                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`.
+                    # @param [Status] status The status of the resources to read. Can be: `init`, `in-progress`, or `completed`. Starting from September 30th, 2026, the default is `in-progress`. To read completed conferences, set `Status` to `completed`.
                     # @param [String] page_token PageToken provided by the API
                     # @param [Integer] page_number Page Number, this value is simply for client state
                     # @param [Integer] page_size Number of records to return, defaults to 50

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

@@ -492,7 +492,7 @@ module Twilio
                         {
                                 "id": @id,
                                 "title": @title,
-                                "timeSlots": @time_slots,
+                                "time_slots": @time_slots,
                         }.to_json(options)
                         end
                     end
@@ -1114,7 +1114,7 @@ module Twilio
                         {
                                 "id": @id,
                                 "title": @title,
-                                "timeSlots": @time_slots,
+                                "time_slots": @time_slots,
                         }.to_json(options)
                         end
                     end

data/lib/twilio-ruby/rest/conversations/v2/action.rb

@@ -353,6 +353,7 @@ module Twilio
                             'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
                             'updated_at' => Twilio.deserialize_iso8601_datetime(payload['updated_at']),
                             'completed_at' => Twilio.deserialize_iso8601_datetime(payload['completed_at']),
+                            'failure_reason' => payload['failure_reason'],
                         }
 
                         # Context
@@ -378,7 +379,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [String] The type of action. Accepted values: SEND_MESSAGE.
+                    # @return [String] The type of action: action-send-message or action-start-flow.
                     def type
                         @properties['type']
                     end
@@ -396,7 +397,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [Hash<String, String>] Named identifiers from downstream. For SEND_MESSAGE: - messageSid: The downstream message SID (present when PENDING or COMPLETED) - communicationId: The Communication ID (present when COMPLETED) 
+                    # @return [Hash<String, String>] Named identifiers from downstream. For SEND_MESSAGE: - messageSid: The downstream message SID (present when PENDING or COMPLETED) - communicationId: The Communication ID (present when COMPLETED) For START_FLOW: - executionSid: The Studio Flow execution SID (present when COMPLETED) 
                     def related
                         @properties['related']
                     end
@@ -419,6 +420,12 @@ module Twilio
                         @properties['completed_at']
                     end
                     
+                    ##
+                    # @return [String] Human-readable failure reason. Null unless status is FAILED.
+                    def failure_reason
+                        @properties['failure_reason']
+                    end
+                    
                     ##
                     # Fetch the ActionInstance
                     # @return [ActionInstance] Fetched ActionInstance

data/lib/twilio-ruby/rest/conversations/v2/communication.rb

@@ -83,13 +83,15 @@ module Twilio
                             # @param [author]: [CommunicationList.CreateCommunicationInConversationRequestAuthor] 
                             # @param [content]: [CommunicationList.CreateCommunicationInConversationRequestContent] 
                             # @param [channel_id]: [String] 
+                            # @param [resource_id]: [String] External resource identifier for this Communication (e.g. MessageSid for SMS/RCS/WhatsApp, TranscriptionSid + MessageIndex for Voice). If a Communication with the same resourceId already exists in the Conversation, it is updated instead of a new one being created.
                             # @param [recipients]: [Array<CommunicationList.CreateCommunicationInConversationRequestRecipients>] 
                             # @param [occurred_at]: [Time] Timestamp when this Communication occurred. If omitted, the server uses the current time.
-                        attr_accessor :author, :content, :channel_id, :recipients, :occurred_at
+                        attr_accessor :author, :content, :channel_id, :resource_id, :recipients, :occurred_at
                         def initialize(payload)
                                 @author = payload["author"]
                                 @content = payload["content"]
                                 @channel_id = payload["channel_id"]
+                                @resource_id = payload["resource_id"]
                                 @recipients = payload["recipients"]
                                 @occurred_at = payload["occurred_at"]
                         end
@@ -98,6 +100,7 @@ module Twilio
                                 "author": @author,
                                 "content": @content,
                                 "channelId": @channel_id,
+                                "resourceId": @resource_id,
                                 "recipients": @recipients,
                                 "occurredAt": @occurred_at,
                         }.to_json(options)

data/lib/twilio-ruby/rest/conversations/v2/configuration.rb

@@ -1584,6 +1584,8 @@ module Twilio
                             'channel_settings' => payload['channel_settings'],
                             'status_callbacks' => payload['status_callbacks'],
                             'intelligence_configuration_ids' => payload['intelligence_configuration_ids'],
+                            'trait_extraction_strategy_ids' => payload['trait_extraction_strategy_ids'],
+                            'observation_extraction_strategy_ids' => payload['observation_extraction_strategy_ids'],
                             'memory_extraction_enabled' => payload['memory_extraction_enabled'],
                             'conversations_v1_bridge' => payload['conversations_v1_bridge'],
                             'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
@@ -1667,6 +1669,18 @@ module Twilio
                         @properties['intelligence_configuration_ids']
                     end
                     
+                    ##
+                    # @return [Array<String>] A list of Trait Extraction Strategy IDs.
+                    def trait_extraction_strategy_ids
+                        @properties['trait_extraction_strategy_ids']
+                    end
+                    
+                    ##
+                    # @return [Array<String>] A list of Observation Extraction Strategy IDs.
+                    def observation_extraction_strategy_ids
+                        @properties['observation_extraction_strategy_ids']
+                    end
+                    
                     ##
                     # @return [Boolean] Whether memory extraction is enabled for conversations under this configuration. Defaults to false.
                     def memory_extraction_enabled

data/lib/twilio-ruby/rest/conversations/v2/conversation.rb

@@ -113,15 +113,21 @@ module Twilio
 
                     class CreateConversationWithConfigRequestConfiguration
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
+                            # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
+                            # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :workflows
+                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
                         def initialize(payload)
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
+                                @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
+                                @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
+                                "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
+                                "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
@@ -317,15 +323,21 @@ module Twilio
 
                     class CreateConversationWithConfigRequestConfiguration
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
+                            # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
+                            # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :workflows
+                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
                         def initialize(payload)
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
+                                @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
+                                @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
+                                "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
+                                "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
@@ -521,15 +533,21 @@ module Twilio
 
                     class CreateConversationWithConfigRequestConfiguration
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
+                            # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
+                            # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :workflows
+                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
                         def initialize(payload)
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
+                                @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
+                                @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
+                                "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
+                                "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
@@ -1229,6 +1247,8 @@ module Twilio
                             'channel_settings' => payload['channel_settings'],
                             'status_callbacks' => payload['status_callbacks'],
                             'intelligence_configuration_ids' => payload['intelligence_configuration_ids'],
+                            'trait_extraction_strategy_ids' => payload['trait_extraction_strategy_ids'],
+                            'observation_extraction_strategy_ids' => payload['observation_extraction_strategy_ids'],
                             'memory_extraction_enabled' => payload['memory_extraction_enabled'],
                             'conversations_v1_bridge' => payload['conversations_v1_bridge'],
                             'version' => payload['version'],
@@ -1370,6 +1390,18 @@ module Twilio
                         @properties['intelligence_configuration_ids']
                     end
                     
+                    ##
+                    # @return [Array<String>] A list of Trait Extraction Strategy IDs.
+                    def trait_extraction_strategy_ids
+                        @properties['trait_extraction_strategy_ids']
+                    end
+                    
+                    ##
+                    # @return [Array<String>] A list of Observation Extraction Strategy IDs.
+                    def observation_extraction_strategy_ids
+                        @properties['observation_extraction_strategy_ids']
+                    end
+                    
                     ##
                     # @return [Boolean] Whether memory extraction is enabled for conversations under this configuration. Defaults to false.
                     def memory_extraction_enabled

data/lib/twilio-ruby/rest/insights/v1/call/call_summary.rb

@@ -369,7 +369,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [Array<String>] Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
+                    # @return [Array<String>] [Tags](https://www.twilio.com/docs/voice/voice-insights/api/call/details-call-tags) that Voice Insights analysis applies to calls. They indicate a condition that may influence the subjective experience of call audio quality.
                     def tags
                         @properties['tags']
                     end

data/lib/twilio-ruby/rest/insights/v1/call_summaries.rb

@@ -681,7 +681,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [Array<String>] Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.
+                    # @return [Array<String>] [Tags](https://www.twilio.com/docs/voice/voice-insights/api/call/details-call-tags) that Voice Insights analysis applies to calls. They indicate a condition that may influence the subjective experience of call audio quality.
                     def tags
                         @properties['tags']
                     end