telnyx 5.159.0 → 5.161.0

data/lib/telnyx/resources/messaging_hosted_number_orders/actions.rb

@@ -9,7 +9,7 @@ module Telnyx
         # {Telnyx::Models::MessagingHostedNumberOrders::ActionUploadFileParams} for more
         # details.
         #
-        # Upload hosted number document
+        # Uploads a supporting document to the specified hosted-messaging order.
         #
         # @overload upload_file(id, bill: nil, loa: nil, request_options: {})
         #

data/lib/telnyx/resources/messaging_hosted_number_orders.rb

@@ -11,7 +11,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingHostedNumberOrderCreateParams} for more details.
       #
-      # Create a messaging hosted number order
+      # Creates an order to enable Telnyx messaging on phone numbers whose voice service
+      # remains with another carrier.
       #
       # @overload create(messaging_profile_id: nil, phone_numbers: nil, request_options: {})
       #
@@ -35,7 +36,8 @@ module Telnyx
         )
       end
 
-      # Retrieve a messaging hosted number order
+      # Returns the current state, phone numbers, and required actions for the specified
+      # hosted-messaging order.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -55,7 +57,8 @@ module Telnyx
         )
       end
 
-      # List messaging hosted number orders
+      # Returns hosted-messaging orders for the authenticated account. Apply the
+      # documented filters and pagination parameters to narrow the result set.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #
@@ -99,7 +102,8 @@ module Telnyx
         )
       end
 
-      # Check hosted messaging eligibility
+      # Checks whether the supplied phone numbers are eligible for hosted messaging
+      # before an order is created.
       #
       # @overload check_eligibility(phone_numbers:, request_options: {})
       #

data/lib/telnyx/resources/messaging_hosted_numbers.rb

@@ -95,7 +95,7 @@ module Telnyx
         )
       end
 
-      # Delete a messaging hosted number
+      # Removes the specified hosted number from Telnyx messaging management.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/messaging_numbers_bulk_updates.rb

@@ -7,7 +7,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingNumbersBulkUpdateCreateParams} for more details.
       #
-      # Bulk update phone number profiles
+      # Starts a bulk update of messaging-profile assignments for the supplied phone
+      # numbers. The response identifies the order used to monitor processing.
       #
       # @overload create(messaging_profile_id:, numbers:, assign_only: nil, request_options: {})
       #
@@ -33,7 +34,8 @@ module Telnyx
         )
       end
 
-      # Retrieve bulk update status
+      # Returns processing status and results for a bulk messaging-settings update
+      # order.
       #
       # @overload retrieve(order_id, request_options: {})
       #

data/lib/telnyx/resources/messaging_profiles/autoresp_configs.rb

@@ -5,7 +5,8 @@ module Telnyx
     class MessagingProfiles
       # Opt-Out Management
       class AutorespConfigs
-        # Create auto-response setting
+        # Creates an auto-response rule on the specified messaging profile. Matching
+        # inbound messages trigger the configured response.
         #
         # @overload create(profile_id, country_code:, keywords:, op:, resp_text: nil, request_options: {})
         #
@@ -35,7 +36,8 @@ module Telnyx
           )
         end
 
-        # Get Auto-Response Setting
+        # Returns the matching criteria and response content for the specified
+        # auto-response rule.
         #
         # @overload retrieve(autoresp_cfg_id, profile_id:, request_options: {})
         #
@@ -62,7 +64,7 @@ module Telnyx
           )
         end
 
-        # Update Auto-Response Setting
+        # Replaces the configuration of the specified auto-response rule.
         #
         # @overload update(autoresp_cfg_id, profile_id:, country_code:, keywords:, op:, resp_text: nil, request_options: {})
         #
@@ -101,7 +103,7 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::MessagingProfiles::AutorespConfigListParams} for more details.
         #
-        # List Auto-Response Settings
+        # Returns the auto-response rules configured for the specified messaging profile.
         #
         # @overload list(profile_id, country_code: nil, created_at: nil, updated_at: nil, request_options: {})
         #
@@ -130,7 +132,7 @@ module Telnyx
           )
         end
 
-        # Delete Auto-Response Setting
+        # Deletes the specified auto-response rule from the messaging profile.
         #
         # @overload delete(autoresp_cfg_id, profile_id:, request_options: {})
         #

data/lib/telnyx/resources/messaging_profiles.rb

@@ -13,7 +13,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingProfileCreateParams} for more details.
       #
-      # Create a messaging profile
+      # Creates a messaging profile that controls outbound sender selection, webhook
+      # delivery, and inbound message handling for associated numbers and short codes.
       #
       # @overload create(name:, whitelisted_destinations:, ai_assistant_id: nil, alpha_sender: nil, daily_spend_limit: nil, daily_spend_limit_enabled: nil, enabled: nil, health_webhook_url: nil, mms_fall_back_to_sms: nil, mms_transcoding: nil, mobile_only: nil, number_pool_settings: nil, resource_group_id: nil, smart_encoding: nil, url_shortener_settings: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -69,7 +70,8 @@ module Telnyx
         )
       end
 
-      # Retrieve a messaging profile
+      # Returns the complete configuration of the specified messaging profile, including
+      # webhook and sender-selection settings.
       #
       # @overload retrieve(messaging_profile_id, request_options: {})
       #
@@ -92,7 +94,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingProfileUpdateParams} for more details.
       #
-      # Update a messaging profile
+      # Updates the supplied settings on the specified messaging profile. Settings
+      # omitted from the request remain unchanged.
       #
       # @overload update(messaging_profile_id, ai_assistant_id: nil, alpha_sender: nil, daily_spend_limit: nil, daily_spend_limit_enabled: nil, enabled: nil, mms_fall_back_to_sms: nil, mms_transcoding: nil, mobile_only: nil, name: nil, number_pool_settings: nil, smart_encoding: nil, url_shortener_settings: nil, v1_secret: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, whitelisted_destinations: nil, request_options: {})
       #
@@ -148,7 +151,8 @@ module Telnyx
         )
       end
 
-      # List messaging profiles
+      # Returns messaging profiles owned by the authenticated account. Apply the
+      # documented filters and pagination parameters to narrow the result set.
       #
       # @overload list(filter: nil, filter_name_contains: nil, filter_name_eq: nil, page_number: nil, page_size: nil, request_options: {})
       #
@@ -185,7 +189,8 @@ module Telnyx
         )
       end
 
-      # Delete a messaging profile
+      # Deletes the specified messaging profile and returns the profile's final
+      # configuration.
       #
       # @overload delete(messaging_profile_id, request_options: {})
       #
@@ -233,7 +238,8 @@ module Telnyx
         )
       end
 
-      # List phone numbers associated with a messaging profile
+      # Returns the phone numbers currently associated with the specified messaging
+      # profile.
       #
       # @overload list_phone_numbers(messaging_profile_id, page_number: nil, page_size: nil, request_options: {})
       #
@@ -261,7 +267,8 @@ module Telnyx
         )
       end
 
-      # List short codes associated with a messaging profile
+      # Returns the short codes currently associated with the specified messaging
+      # profile.
       #
       # @overload list_short_codes(messaging_profile_id, page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/messaging_tollfree/verification/requests.rb

@@ -64,7 +64,7 @@ module Telnyx
           #
           # @param doing_business_as [String, nil] Doing Business As (DBA) name if different from legal name
           #
-          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::TollFreeVerificationEntityType, nil] Business entity classification
+          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationEntityType, nil] Business entity classification
           #
           # @param help_message_response [String, nil] The message returned when users text 'HELP'
           #
@@ -82,7 +82,7 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestEgress]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestCreateParams
           def create(params)
@@ -91,7 +91,7 @@ module Telnyx
               method: :post,
               path: "messaging_tollfree/verification/requests",
               body: parsed,
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestEgress,
+              model: Telnyx::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress,
               options: options
             )
           end
@@ -104,14 +104,14 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestStatus]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveResponse]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveParams
           def retrieve(id, params = {})
             @client.request(
               method: :get,
               path: ["messaging_tollfree/verification/requests/%1$s", id],
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestStatus,
+              model: Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveResponse,
               options: params[:request_options]
             )
           end
@@ -177,7 +177,7 @@ module Telnyx
           #
           # @param doing_business_as [String, nil] Doing Business As (DBA) name if different from legal name
           #
-          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::TollFreeVerificationEntityType, nil] Business entity classification
+          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationEntityType, nil] Business entity classification
           #
           # @param help_message_response [String, nil] The message returned when users text 'HELP'
           #
@@ -195,7 +195,7 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestEgress]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestUpdateParams
           def update(id, params)
@@ -204,7 +204,7 @@ module Telnyx
               method: :patch,
               path: ["messaging_tollfree/verification/requests/%1$s", id],
               body: parsed,
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestEgress,
+              model: Telnyx::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress,
               options: options
             )
           end

data/lib/telnyx/resources/messaging_url_domains.rb

@@ -4,7 +4,8 @@ module Telnyx
   module Resources
     # Messaging URL Domains
     class MessagingURLDomains
-      # List messaging URL domains
+      # Returns the URL domains available to the authenticated account for message URL
+      # shortening.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/mobile_phone_numbers/messaging.rb

@@ -4,7 +4,7 @@ module Telnyx
   module Resources
     class MobilePhoneNumbers
       class Messaging
-        # Retrieve a mobile phone number with messaging settings
+        # Returns the messaging configuration for the specified mobile phone number.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -24,7 +24,7 @@ module Telnyx
           )
         end
 
-        # List mobile phone numbers with messaging settings
+        # Returns mobile phone numbers with their current messaging configuration.
         #
         # @overload list(page_number: nil, page_size: nil, request_options: {})
         #

data/lib/telnyx/resources/mobile_phone_numbers.rb

@@ -7,7 +7,7 @@ module Telnyx
       # @return [Telnyx::Resources::MobilePhoneNumbers::Messaging]
       attr_reader :messaging
 
-      # Retrieve a Mobile Phone Number
+      # Retrieve the details of a specific mobile phone number.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -27,7 +27,7 @@ module Telnyx
         )
       end
 
-      # Update a Mobile Phone Number
+      # Update the settings of a specific mobile phone number.
       #
       # @overload update(id, call_forwarding: nil, call_recording: nil, caller_id_name_enabled: nil, cnam_listing: nil, connection_id: nil, customer_reference: nil, inbound: nil, inbound_call_screening: nil, noise_suppression: nil, outbound: nil, tags: nil, request_options: {})
       #
@@ -71,7 +71,7 @@ module Telnyx
         )
       end
 
-      # List Mobile Phone Numbers
+      # Retrieve a paginated list of mobile phone numbers on your account.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/mobile_voice_connections.rb

@@ -4,7 +4,7 @@ module Telnyx
   module Resources
     # Mobile voice connection operations
     class MobileVoiceConnections
-      # Create a Mobile Voice Connection
+      # Create a new mobile voice connection.
       #
       # @overload create(active: nil, connection_name: nil, inbound: nil, outbound: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
@@ -33,7 +33,7 @@ module Telnyx
         )
       end
 
-      # Retrieve a Mobile Voice Connection
+      # Retrieve the details of a specific mobile voice connection.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -53,7 +53,7 @@ module Telnyx
         )
       end
 
-      # Update a Mobile Voice Connection
+      # Update the settings of a specific mobile voice connection.
       #
       # @overload update(id, active: nil, connection_name: nil, inbound: nil, outbound: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
@@ -96,7 +96,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MobileVoiceConnectionListParams} for more details.
       #
-      # List Mobile Voice Connections
+      # Retrieve a paginated list of mobile voice connections on your account.
       #
       # @overload list(filter_connection_name_contains: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
       #
@@ -130,7 +130,7 @@ module Telnyx
         )
       end
 
-      # Delete a Mobile Voice Connection
+      # Delete a mobile voice connection from your account.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/number_order_phone_numbers.rb

@@ -49,7 +49,8 @@ module Telnyx
         )
       end
 
-      # Update requirement group for a phone number order
+      # Associates an existing requirement group with a phone number in a number order.
+      # The response contains the updated number-order phone-number details.
       #
       # @overload update_requirement_group(id, requirement_group_id:, request_options: {})
       #

data/lib/telnyx/resources/ota_updates.rb

@@ -27,7 +27,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::OtaUpdateListParams} for more details.
       #
-      # List OTA updates
+      # Retrieve a paginated list of over-the-air (OTA) update operations for your SIM
+      # cards.
       #
       # @overload list(filter: nil, page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/payment.rb

@@ -8,7 +8,7 @@ module Telnyx
       # @return [Telnyx::Resources::Payment::AutoRechargePrefs]
       attr_reader :auto_recharge_prefs
 
-      # Create a stored payment transaction
+      # Create a transaction that charges a stored payment method on the account.
       #
       # @overload create_stored_payment_transaction(amount:, request_options: {})
       #

data/lib/telnyx/resources/phone_number_blocks/jobs.rb

@@ -5,7 +5,8 @@ module Telnyx
     class PhoneNumberBlocks
       # Background jobs performed over a phone-numbers block's phone numbers
       class Jobs
-        # Retrieves a phone number blocks job
+        # Returns the status and details of the phone-number-block background job
+        # identified by `id`.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -28,7 +29,9 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumberBlocks::JobListParams} for more details.
         #
-        # Lists the phone number blocks jobs
+        # Returns background jobs that operate on phone-number blocks. Results can be
+        # filtered by job type and status, sorted by creation time, and include pagination
+        # metadata.
         #
         # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/actions.rb

@@ -8,8 +8,9 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::ActionChangeBundleStatusParams} for more details.
         #
-        # Change the bundle status for a phone number (set to being in a bundle or remove
-        # from a bundle)
+        # Adds the specified phone number to a bundle or removes it from a bundle
+        # according to the requested status change. The response contains the phone number
+        # with its updated bundle state.
         #
         # @overload change_bundle_status(id, bundle_id:, request_options: {})
         #
@@ -33,7 +34,9 @@ module Telnyx
           )
         end
 
-        # Enable emergency for a phone number
+        # Associates emergency-service settings with the specified phone number. The
+        # operation returns the updated phone-number configuration when completed
+        # immediately or an accepted state when processing continues asynchronously.
         #
         # @overload enable_emergency(id, emergency_address_id:, emergency_enabled:, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/csv_downloads.rb

@@ -7,7 +7,9 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::CsvDownloadCreateParams} for more details.
         #
-        # Create a CSV download
+        # Starts generation of a CSV export for phone numbers matching the supplied
+        # filters. The `csv_format` parameter selects the output format, and the response
+        # contains the resulting download record.
         #
         # @overload create(csv_format: nil, filter: nil, request_options: {})
         #
@@ -32,7 +34,8 @@ module Telnyx
           )
         end
 
-        # Retrieve a CSV download
+        # Returns the current status and download details for the CSV export identified by
+        # `id`.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -52,7 +55,8 @@ module Telnyx
           )
         end
 
-        # List CSV downloads
+        # Returns CSV export jobs created for account phone numbers, including each
+        # export's current status and pagination metadata.
         #
         # @overload list(page_number: nil, page_size: nil, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/jobs.rb

@@ -5,7 +5,8 @@ module Telnyx
     class PhoneNumbers
       # Background jobs performed over a batch of phone numbers
       class Jobs
-        # Retrieve a phone numbers job
+        # Returns the status and details of the phone-number background job identified by
+        # `id`.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -28,7 +29,8 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::JobListParams} for more details.
         #
-        # Lists the phone numbers jobs
+        # Returns background jobs that operate on phone numbers. Results can be filtered
+        # by job type and sorted by creation time, and include pagination metadata.
         #
         # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/messaging.rb

@@ -5,7 +5,8 @@ module Telnyx
     class PhoneNumbers
       # Configure your phone numbers
       class Messaging
-        # Retrieve a phone number with messaging settings
+        # Returns the messaging product and messaging-profile assignment for the specified
+        # phone number.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -28,7 +29,8 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::MessagingUpdateParams} for more details.
         #
-        # Update the messaging profile and/or messaging product of a phone number
+        # Updates the messaging product, messaging profile, or both for the specified
+        # phone number.
         #
         # @overload update(id, messaging_product: nil, messaging_profile_id: nil, tags: nil, request_options: {})
         #
@@ -56,7 +58,8 @@ module Telnyx
           )
         end
 
-        # List phone numbers with messaging settings
+        # Returns phone numbers with their current messaging product and messaging-profile
+        # assignments.
         #
         # @overload list(filter_messaging_profile_id: nil, filter_phone_number: nil, filter_phone_number_contains: nil, filter_type: nil, page_number: nil, page_size: nil, sort_phone_number: nil, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/voice.rb

@@ -5,7 +5,8 @@ module Telnyx
     class PhoneNumbers
       # Configure your phone numbers
       class Voice
-        # Retrieve a phone number with voice settings
+        # Returns the specified phone number together with its current voice
+        # configuration.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -28,7 +29,8 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::VoiceUpdateParams} for more details.
         #
-        # Update a phone number with voice settings
+        # Updates the voice configuration for the specified phone number. The response
+        # contains the phone number with its updated voice settings.
         #
         # @overload update(id, call_forwarding: nil, call_recording: nil, caller_id_name_enabled: nil, cnam_listing: nil, inbound_call_screening: nil, media_features: nil, tech_prefix_enabled: nil, translated_number: nil, usage_payment_method: nil, request_options: {})
         #
@@ -71,7 +73,9 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::PhoneNumbers::VoiceListParams} for more details.
         #
-        # List phone numbers with voice settings
+        # Returns account phone numbers together with their voice settings. Results
+        # support pagination, sorting, and filters for number, connection name, customer
+        # reference, and voice usage payment method.
         #
         # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
         #

data/lib/telnyx/resources/phone_numbers/voicemail.rb

@@ -5,14 +5,22 @@ module Telnyx
     class PhoneNumbers
       # Voicemail API
       class Voicemail
-        # Create voicemail settings for a phone number
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::PhoneNumbers::VoicemailCreateParams} for more details.
         #
-        # @overload create(phone_number_id, enabled: nil, pin: nil, request_options: {})
+        # Create voicemail settings for a phone number. You can also configure a custom
+        # greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+        # with a `media_name` that points to an audio file uploaded through the Media
+        # Storage API, or `mode` `default` to use the standard system greeting.
+        #
+        # @overload create(phone_number_id, enabled: nil, greeting: nil, pin: nil, request_options: {})
         #
         # @param phone_number_id [String] The ID of the phone number.
         #
         # @param enabled [Boolean] Whether voicemail is enabled.
         #
+        # @param greeting [Telnyx::Models::PhoneNumbers::VoicemailRequest::Greeting] Controls the greeting a caller hears before leaving a voicemail. Set `mode` to `
+        #
         # @param pin [String] The pin used for voicemail
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -51,14 +59,22 @@ module Telnyx
           )
         end
 
-        # Update voicemail settings for a phone number
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::PhoneNumbers::VoicemailUpdateParams} for more details.
         #
-        # @overload update(phone_number_id, enabled: nil, pin: nil, request_options: {})
+        # Update voicemail settings for a phone number. You can also configure a custom
+        # greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+        # with a `media_name` that points to an audio file uploaded through the Media
+        # Storage API, or `mode` `default` to use the standard system greeting.
+        #
+        # @overload update(phone_number_id, enabled: nil, greeting: nil, pin: nil, request_options: {})
         #
         # @param phone_number_id [String] The ID of the phone number.
         #
         # @param enabled [Boolean] Whether voicemail is enabled.
         #
+        # @param greeting [Telnyx::Models::PhoneNumbers::VoicemailRequest::Greeting] Controls the greeting a caller hears before leaving a voicemail. Set `mode` to `
+        #
         # @param pin [String] The pin used for voicemail
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]