telnyx 5.162.0 → 5.164.0

data/lib/telnyx/models/wireless_blocklist_value_list_response.rb

@@ -6,17 +6,11 @@ module Telnyx
     class WirelessBlocklistValueListResponse < Telnyx::Internal::Type::BaseModel
       # @!attribute data
       #
-      #   @return [Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Country>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Mcc>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Plmn>, nil]
-      optional :data, union: -> { Telnyx::Models::WirelessBlocklistValueListResponse::Data }
+      #   @return [Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Country>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Mcc>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Plmn>]
+      required :data, union: -> { Telnyx::Models::WirelessBlocklistValueListResponse::Data }
 
-      # @!attribute meta
-      #
-      #   @return [Telnyx::Models::PaginationMeta, nil]
-      optional :meta, -> { Telnyx::PaginationMeta }
-
-      # @!method initialize(data: nil, meta: nil)
+      # @!method initialize(data:)
       #   @param data [Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Country>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Mcc>, Array<Telnyx::Models::WirelessBlocklistValueListResponse::Data::Plmn>]
-      #   @param meta [Telnyx::Models::PaginationMeta]
 
       # @see Telnyx::Models::WirelessBlocklistValueListResponse#data
       module Data
@@ -29,60 +23,36 @@ module Telnyx
         variant -> { Telnyx::Models::WirelessBlocklistValueListResponse::Data::PlmnArray }
 
         class Country < Telnyx::Internal::Type::BaseModel
-          # @!attribute code
+          # @!attribute country_code
           #   ISO 3166-1 Alpha-2 Country Code.
           #
           #   @return [String]
-          required :code, String
+          required :country_code, String
 
-          # @!attribute name
-          #   The name of the country.
-          #
-          #   @return [String]
-          required :name, String
-
-          # @!method initialize(code:, name:)
-          #   @param code [String] ISO 3166-1 Alpha-2 Country Code.
-          #
-          #   @param name [String] The name of the country.
+          # @!method initialize(country_code:)
+          #   @param country_code [String] ISO 3166-1 Alpha-2 Country Code.
         end
 
         class Mcc < Telnyx::Internal::Type::BaseModel
-          # @!attribute code
+          # @!attribute mcc
           #   Mobile Country Code.
           #
           #   @return [String]
-          required :code, String
-
-          # @!attribute name
-          #   The name of the country.
-          #
-          #   @return [String]
-          required :name, String
+          required :mcc, String
 
-          # @!method initialize(code:, name:)
-          #   @param code [String] Mobile Country Code.
-          #
-          #   @param name [String] The name of the country.
+          # @!method initialize(mcc:)
+          #   @param mcc [String] Mobile Country Code.
         end
 
         class Plmn < Telnyx::Internal::Type::BaseModel
-          # @!attribute code
+          # @!attribute plmn
           #   Public land mobile network code (MCC + MNC).
           #
           #   @return [String]
-          required :code, String
+          required :plmn, String
 
-          # @!attribute name
-          #   The name of the network.
-          #
-          #   @return [String]
-          required :name, String
-
-          # @!method initialize(code:, name:)
-          #   @param code [String] Public land mobile network code (MCC + MNC).
-          #
-          #   @param name [String] The name of the network.
+          # @!method initialize(plmn:)
+          #   @param plmn [String] Public land mobile network code (MCC + MNC).
         end
 
         # @!method self.variants

data/lib/telnyx/models/wireless_wireless_blocklist.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::WirelessBlocklists#list
+    class WirelessWirelessBlocklist < Telnyx::Internal::Type::BaseModel
+      # @!attribute name
+      #   The wireless blocklist name.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute type
+      #   The type of the wireless blocklist.
+      #
+      #   @return [Symbol, Telnyx::Models::WirelessWirelessBlocklist::Type, nil]
+      optional :type, enum: -> { Telnyx::WirelessWirelessBlocklist::Type }
+
+      # @!attribute values
+      #   Values to block. The values here depend on the `type` of Wireless Blocklist.
+      #
+      #   @return [Array<String>, nil]
+      optional :values, Telnyx::Internal::Type::ArrayOf[String]
+
+      response_only do
+        # @!attribute id
+        #   Identifies the resource.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute created_at
+        #   ISO 8601 formatted date-time indicating when the resource was created.
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute updated_at
+        #   ISO 8601 formatted date-time indicating when the resource was updated.
+        #
+        #   @return [String, nil]
+        optional :updated_at, String
+      end
+
+      # @!method initialize(id: nil, created_at: nil, name: nil, type: nil, updated_at: nil, values: nil)
+      #   @param id [String] Identifies the resource.
+      #
+      #   @param created_at [String] ISO 8601 formatted date-time indicating when the resource was created.
+      #
+      #   @param name [String] The wireless blocklist name.
+      #
+      #   @param type [Symbol, Telnyx::Models::WirelessWirelessBlocklist::Type] The type of the wireless blocklist.
+      #
+      #   @param updated_at [String] ISO 8601 formatted date-time indicating when the resource was updated.
+      #
+      #   @param values [Array<String>] Values to block. The values here depend on the `type` of Wireless Blocklist.
+
+      # The type of the wireless blocklist.
+      #
+      # @see Telnyx::Models::WirelessWirelessBlocklist#type
+      module Type
+        extend Telnyx::Internal::Type::Enum
+
+        COUNTRY = :country
+        MCC = :mcc
+        PLMN = :plmn
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models.rb

@@ -139,8 +139,6 @@ module Telnyx
 
   BalanceRetrieveParams = Telnyx::Models::BalanceRetrieveParams
 
-  BillingAddress = Telnyx::Models::BillingAddress
-
   BillingContact = Telnyx::Models::BillingContact
 
   BillingGroup = Telnyx::Models::BillingGroup
@@ -770,6 +768,8 @@ module Telnyx
 
   EmailValidationCheck = Telnyx::Models::EmailValidationCheck
 
+  EmailValidationChecks = Telnyx::Models::EmailValidationChecks
+
   EmailValidationCreateParams = Telnyx::Models::EmailValidationCreateParams
 
   EmailValidations = Telnyx::Models::EmailValidations
@@ -948,6 +948,8 @@ module Telnyx
 
   InboundMessageWebhookEvent = Telnyx::Models::InboundMessageWebhookEvent
 
+  InboundSipHeader = Telnyx::Models::InboundSipHeader
+
   InexplicitNumberOrderCreateParams = Telnyx::Models::InexplicitNumberOrderCreateParams
 
   InexplicitNumberOrderListParams = Telnyx::Models::InexplicitNumberOrderListParams
@@ -1145,6 +1147,8 @@ module Telnyx
 
   MessagingHostedNumberUpdateParams = Telnyx::Models::MessagingHostedNumberUpdateParams
 
+  MessagingInboundMessagePayload = Telnyx::Models::MessagingInboundMessagePayload
+
   MessagingMetricsTimeFrame = Telnyx::Models::MessagingMetricsTimeFrame
 
   MessagingNumbersBulkUpdateCreateParams = Telnyx::Models::MessagingNumbersBulkUpdateCreateParams
@@ -1350,6 +1354,8 @@ module Telnyx
 
   NumbersPhoneNumberDetailed = Telnyx::Models::NumbersPhoneNumberDetailed
 
+  NumbersSubNumberOrder = Telnyx::Models::NumbersSubNumberOrder
+
   OAuthClient = Telnyx::Models::OAuthClient
 
   OAuthClientCreateParams = Telnyx::Models::OAuthClientCreateParams
@@ -1685,8 +1691,6 @@ module Telnyx
 
   ReservedPhoneNumber = Telnyx::Models::ReservedPhoneNumber
 
-  RimeVoiceSettings = Telnyx::Models::RimeVoiceSettings
-
   Room = Telnyx::Models::Room
 
   RoomComposition = Telnyx::Models::RoomComposition
@@ -1731,6 +1735,8 @@ module Telnyx
 
   S3ConfigurationData = Telnyx::Models::S3ConfigurationData
 
+  S3GenericConfigurationData = Telnyx::Models::S3GenericConfigurationData
+
   ServicePlan = Telnyx::Models::ServicePlan
 
   SessionAnalysis = Telnyx::Models::SessionAnalysis
@@ -1833,8 +1839,6 @@ module Telnyx
 
   SpeechToTextRetrieveTranscriptionParams = Telnyx::Models::SpeechToTextRetrieveTranscriptionParams
 
-  SpeechToTextTranscribeParams = Telnyx::Models::SpeechToTextTranscribeParams
-
   Storage = Telnyx::Models::Storage
 
   StorageListMigrationSourceCoverageParams = Telnyx::Models::StorageListMigrationSourceCoverageParams
@@ -1876,6 +1880,8 @@ module Telnyx
 
   SubNumberOrderUpdateRequirementGroupParams = Telnyx::Models::SubNumberOrderUpdateRequirementGroupParams
 
+  SuppressedRecipient = Telnyx::Models::SuppressedRecipient
+
   TelephonyCredential = Telnyx::Models::TelephonyCredential
 
   TelephonyCredentialCreateParams = Telnyx::Models::TelephonyCredentialCreateParams
@@ -1920,8 +1926,6 @@ module Telnyx
 
   TextToSpeechRetrieveSpeechParams = Telnyx::Models::TextToSpeechRetrieveSpeechParams
 
-  TextToSpeechStreamParams = Telnyx::Models::TextToSpeechStreamParams
-
   TimeRange = Telnyx::Models::TimeRange
 
   TrackingSettings = Telnyx::Models::TrackingSettings
@@ -2223,6 +2227,8 @@ module Telnyx
 
   WirelessRetrieveRegionsParams = Telnyx::Models::WirelessRetrieveRegionsParams
 
+  WirelessWirelessBlocklist = Telnyx::Models::WirelessWirelessBlocklist
+
   X402 = Telnyx::Models::X402
 
   XaiVoiceSettings = Telnyx::Models::XaiVoiceSettings

data/lib/telnyx/resources/addresses.rb

@@ -31,7 +31,9 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AddressCreateParams} for more details.
       #
-      # Creates an address.
+      # Creates a new address on your account from the provided details, for use with
+      # services that require a physical address such as emergency calling and
+      # regulatory compliance.
       #
       # @overload create(business_name:, country_code:, first_name:, last_name:, locality:, street_address:, address_book: nil, administrative_area: nil, borough: nil, customer_reference: nil, extended_address: nil, neighborhood: nil, phone_number: nil, postal_code: nil, validate_address: nil, request_options: {})
       #
@@ -104,7 +106,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AddressListParams} for more details.
       #
-      # Returns a list of your addresses.
+      # Returns a paginated list of the addresses on your account, with support for
+      # filtering and sorting.
       #
       # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
       #
@@ -134,7 +137,7 @@ module Telnyx
         )
       end
 
-      # Deletes an existing address.
+      # Permanently deletes the specified address from your account.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/ai/anthropic/v1.rb

@@ -26,7 +26,7 @@ module Telnyx
           #
           # @param messages [Array<Hash{Symbol=>Object}>] The messages to send to the model, following the [Anthropic Messages API](https:
           #
-          # @param model [String] The model to use for generating the response, for example `zai-org/GLM-5.2` or a
+          # @param model [String] The model to use for generating the response, for example `zai-org/GLM-5.3-Flash
           #
           # @param api_key_ref [String] If you are using an external inference provider, this field allows you to pass a
           #

data/lib/telnyx/resources/ai/assistants/canary_deploys.rb

@@ -6,16 +6,21 @@ module Telnyx
       class Assistants
         # Configure AI assistant specifications
         class CanaryDeploys
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Assistants::CanaryDeployCreateParams} for more details.
+          #
           # Endpoint to create a canary deploy configuration for an assistant.
           #
           # Creates a new canary deploy configuration with multiple version IDs and their
           # traffic percentages for A/B testing or gradual rollouts of assistant versions.
           #
-          # @overload create(assistant_id, rules: nil, request_options: {})
+          # @overload create(assistant_id, rules: nil, idempotency_key: nil, request_options: {})
           #
-          # @param assistant_id [String] Unique identifier of the assistant.
+          # @param assistant_id [String] Path param: Unique identifier of the assistant.
           #
-          # @param rules [Array<Telnyx::Models::AI::Assistants::RuleInput>]
+          # @param rules [Array<Telnyx::Models::AI::Assistants::RuleInput>] Body param
+          #
+          # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -24,10 +29,12 @@ module Telnyx
           # @see Telnyx::Models::AI::Assistants::CanaryDeployCreateParams
           def create(assistant_id, params = {})
             parsed, options = Telnyx::AI::Assistants::CanaryDeployCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
             @client.request(
               method: :post,
               path: ["ai/assistants/%1$s/canary-deploys", assistant_id],
-              body: parsed,
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
               model: Telnyx::AI::Assistants::CanaryDeployResponse,
               options: options
             )

data/lib/telnyx/resources/ai/assistants/scheduled_events.rb

@@ -11,29 +11,31 @@ module Telnyx
           #
           # Create a scheduled event for an assistant
           #
-          # @overload create(assistant_id, scheduled_at_fixed_datetime:, telnyx_agent_target:, telnyx_conversation_channel:, telnyx_end_user_target:, call_settings: nil, conversation_metadata: nil, dynamic_variables: nil, max_retries_client_errors: nil, retry_interval_secs: nil, text: nil, request_options: {})
+          # @overload create(assistant_id, scheduled_at_fixed_datetime:, telnyx_agent_target:, telnyx_conversation_channel:, telnyx_end_user_target:, call_settings: nil, conversation_metadata: nil, dynamic_variables: nil, max_retries_client_errors: nil, retry_interval_secs: nil, text: nil, idempotency_key: nil, request_options: {})
           #
-          # @param assistant_id [String] Unique identifier of the assistant.
+          # @param assistant_id [String] Path param: Unique identifier of the assistant.
+          #
+          # @param scheduled_at_fixed_datetime [Time] Body param: The datetime at which the event should be scheduled. Formatted as IS
           #
-          # @param scheduled_at_fixed_datetime [Time] The datetime at which the event should be scheduled. Formatted as ISO 8601.
+          # @param telnyx_agent_target [String] Body param: The phone number, SIP URI, to schedule the call or text from.
           #
-          # @param telnyx_agent_target [String] The phone number, SIP URI, to schedule the call or text from.
+          # @param telnyx_conversation_channel [Symbol, Telnyx::Models::AI::Assistants::ConversationChannelType] Body param
           #
-          # @param telnyx_conversation_channel [Symbol, Telnyx::Models::AI::Assistants::ConversationChannelType]
+          # @param telnyx_end_user_target [String] Body param: The phone number, SIP URI, to schedule the call or text to.
           #
-          # @param telnyx_end_user_target [String] The phone number, SIP URI, to schedule the call or text to.
+          # @param call_settings [Telnyx::Models::AI::Assistants::ScheduledCallSettings] Body param: Per-call telephony overrides applied when a scheduled phone-call eve
           #
-          # @param call_settings [Telnyx::Models::AI::Assistants::ScheduledCallSettings] Per-call telephony overrides applied when a scheduled phone-call event
+          # @param conversation_metadata [Hash{Symbol=>String, Integer, Boolean}] Body param: Metadata associated with the conversation. Telnyx provides several p
           #
-          # @param conversation_metadata [Hash{Symbol=>String, Integer, Boolean}] Metadata associated with the conversation. Telnyx provides several pieces of met
+          # @param dynamic_variables [Hash{Symbol=>String}] Body param: A map of dynamic variable names to values. These variables can be re
           #
-          # @param dynamic_variables [Hash{Symbol=>String}] A map of dynamic variable names to values. These variables can be referenced in
+          # @param max_retries_client_errors [Integer] Body param: Configure number of retries on client errors: busy, no-answer, faile
           #
-          # @param max_retries_client_errors [Integer] Configure number of retries on client errors: busy, no-answer, failed, canceled
+          # @param retry_interval_secs [Integer] Body param
           #
-          # @param retry_interval_secs [Integer]
+          # @param text [String] Body param: Required for sms scheduled events. The text to be sent to the end us
           #
-          # @param text [String] Required for sms scheduled events. The text to be sent to the end user.
+          # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -42,16 +44,19 @@ module Telnyx
           # @see Telnyx::Models::AI::Assistants::ScheduledEventCreateParams
           def create(assistant_id, params)
             parsed, options = Telnyx::AI::Assistants::ScheduledEventCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
             @client.request(
               method: :post,
               path: ["ai/assistants/%1$s/scheduled_events", assistant_id],
-              body: parsed,
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
               model: Telnyx::AI::Assistants::ScheduledEventResponse,
               options: options
             )
           end
 
-          # Retrieve a scheduled event by event ID
+          # Returns the details of a single scheduled event configured for the specified
+          # assistant.
           #
           # @overload retrieve(event_id, assistant_id:, request_options: {})
           #

data/lib/telnyx/resources/ai/assistants/tags.rb

@@ -48,7 +48,8 @@ module Telnyx
             )
           end
 
-          # Remove a tag from an AI assistant.
+          # Removes the specified tag from the AI assistant and returns the assistant's
+          # updated tag list.
           #
           # @overload remove(tag, assistant_id:, request_options: {})
           #

data/lib/telnyx/resources/ai/assistants/tests/runs.rb

@@ -70,11 +70,13 @@ module Telnyx
             #
             # Initiates immediate execution of a specific assistant test
             #
-            # @overload trigger(test_id, destination_version_id: nil, request_options: {})
+            # @overload trigger(test_id, destination_version_id: nil, idempotency_key: nil, request_options: {})
             #
-            # @param test_id [String] Unique identifier of the test.
+            # @param test_id [String] Path param: Unique identifier of the test.
+            #
+            # @param destination_version_id [String] Body param: Optional assistant version ID to use for this test run. If provided,
             #
-            # @param destination_version_id [String] Optional assistant version ID to use for this test run. If provided, the version
+            # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
             #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -83,10 +85,12 @@ module Telnyx
             # @see Telnyx::Models::AI::Assistants::Tests::RunTriggerParams
             def trigger(test_id, params = {})
               parsed, options = Telnyx::AI::Assistants::Tests::RunTriggerParams.dump_request(params)
+              header_params = {idempotency_key: "idempotency-key"}
               @client.request(
                 method: :post,
                 path: ["ai/assistants/tests/%1$s/runs", test_id],
-                body: parsed,
+                headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                body: parsed.except(*header_params.keys),
                 model: Telnyx::AI::Assistants::Tests::TestRunResponse,
                 options: options
               )

data/lib/telnyx/resources/ai/assistants/tests/test_suites/runs.rb

@@ -47,11 +47,13 @@ module Telnyx
               #
               # Executes all tests within a specific test suite as a batch operation
               #
-              # @overload trigger(suite_name, destination_version_id: nil, request_options: {})
+              # @overload trigger(suite_name, destination_version_id: nil, idempotency_key: nil, request_options: {})
               #
-              # @param suite_name [String] Name of the suite.
+              # @param suite_name [String] Path param: Name of the suite.
+              #
+              # @param destination_version_id [String] Body param: Optional assistant version ID to use for all test runs in this suite
               #
-              # @param destination_version_id [String] Optional assistant version ID to use for all test runs in this suite. If provide
+              # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
               #
               # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
               #
@@ -60,10 +62,12 @@ module Telnyx
               # @see Telnyx::Models::AI::Assistants::Tests::TestSuites::RunTriggerParams
               def trigger(suite_name, params = {})
                 parsed, options = Telnyx::AI::Assistants::Tests::TestSuites::RunTriggerParams.dump_request(params)
+                header_params = {idempotency_key: "idempotency-key"}
                 @client.request(
                   method: :post,
                   path: ["ai/assistants/tests/test-suites/%1$s/runs", suite_name],
-                  body: parsed,
+                  headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                  body: parsed.except(*header_params.keys),
                   model: Telnyx::Internal::Type::ArrayOf[Telnyx::AI::Assistants::Tests::TestRunResponse],
                   options: options
                 )

data/lib/telnyx/resources/ai/assistants/tests.rb

@@ -20,23 +20,25 @@ module Telnyx
           # Creates a comprehensive test configuration for evaluating AI assistant
           # performance
           #
-          # @overload create(destination:, instructions:, name:, rubric:, description: nil, max_duration_seconds: nil, telnyx_conversation_channel: nil, test_suite: nil, request_options: {})
+          # @overload create(destination:, instructions:, name:, rubric:, description: nil, max_duration_seconds: nil, telnyx_conversation_channel: nil, test_suite: nil, idempotency_key: nil, request_options: {})
           #
-          # @param destination [String] The target destination for the test conversation. Format depends on the channel:
+          # @param destination [String] Body param: The target destination for the test conversation. Format depends on
           #
-          # @param instructions [String] Detailed instructions that define the test scenario and what the assistant shoul
+          # @param instructions [String] Body param: Detailed instructions that define the test scenario and what the ass
           #
-          # @param name [String] A descriptive name for the assistant test. This will be used to identify the tes
+          # @param name [String] Body param: A descriptive name for the assistant test. This will be used to iden
           #
-          # @param rubric [Array<Telnyx::Models::AI::Assistants::TestCreateParams::Rubric>] Evaluation criteria used to assess the assistant's performance. Each rubric item
+          # @param rubric [Array<Telnyx::Models::AI::Assistants::TestCreateParams::Rubric>] Body param: Evaluation criteria used to assess the assistant's performance. Each
           #
-          # @param description [String] Optional detailed description of what this test evaluates and its purpose. Helps
+          # @param description [String] Body param: Optional detailed description of what this test evaluates and its pu
           #
-          # @param max_duration_seconds [Integer] Maximum duration in seconds that the test conversation should run before timing
+          # @param max_duration_seconds [Integer] Body param: Maximum duration in seconds that the test conversation should run be
           #
-          # @param telnyx_conversation_channel [Symbol, Telnyx::Models::AI::Assistants::TelnyxConversationChannel] The communication channel through which the test will be conducted. Determines h
+          # @param telnyx_conversation_channel [Symbol, Telnyx::Models::AI::Assistants::TelnyxConversationChannel] Body param: The communication channel through which the test will be conducted.
           #
-          # @param test_suite [String] Optional test suite name to group related tests together. Useful for organizing
+          # @param test_suite [String] Body param: Optional test suite name to group related tests together. Useful for
+          #
+          # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -45,10 +47,12 @@ module Telnyx
           # @see Telnyx::Models::AI::Assistants::TestCreateParams
           def create(params)
             parsed, options = Telnyx::AI::Assistants::TestCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
             @client.request(
               method: :post,
               path: "ai/assistants/tests",
-              body: parsed,
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
               model: Telnyx::AI::Assistants::AssistantTest,
               options: options
             )

data/lib/telnyx/resources/ai/assistants/tools.rb

@@ -33,7 +33,8 @@ module Telnyx
             )
           end
 
-          # Detach a tool from an AI assistant.
+          # Detaches the specified tool from the AI assistant so the assistant can no longer
+          # invoke it.
           #
           # @overload remove(tool_id, assistant_id:, request_options: {})
           #
@@ -60,7 +61,9 @@ module Telnyx
             )
           end
 
-          # Test a webhook tool for an assistant
+          # Executes a test invocation of the specified webhook tool for the assistant and
+          # returns the outcome, so you can verify the webhook's behavior before relying on
+          # it in conversations.
           #
           # @overload test_(tool_id, assistant_id:, arguments: nil, dynamic_variables: nil, request_options: {})
           #