telnyx 5.130.0 → 5.131.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edd5e900dcfd85824a24019b495996abb5010aa4d0026ca63dcb15d86c7389dd
-  data.tar.gz: 8617e123a5bc3953ab8eec95b6804cd5c1841463f2e35172913dac3e0299cafc
+  metadata.gz: 73131dbc369d6c33a4f6e65b18e8ddbd47926435cddb70fb43ea8bd13d857112
+  data.tar.gz: f3e5435f05230963682b2ae8635867781ffed007c9951e2abc8ccfe6690b6812
 SHA512:
-  metadata.gz: df3c725bf99a553a515117436bea685af65a4ef8cdd18f564510a3a7ba9fae608f94ee8a75677f6f311fd9829db48939285f2a48adecab90f5589a39483faa8b
-  data.tar.gz: a8c2e2f2039ba504c0afbe11ad28c05f23db139ddb18242d673f93f844f9c1142da1b361e6b19dbe2a1ce417fe296fd449dc92a4b27ecd69bc25ab669317126e
+  metadata.gz: 97cdbbacb6a720ce2ca843f62a050117f805188ee1f431485bb776c449820465d58717ce5aea3df27919ffb19252d12ca2c23925dadecd6d1bf7e1f410c85bb6
+  data.tar.gz: a797fe358bb7fd3019ce6111126d2d417ec2e503042f73262a2e8c07d2553c8fceec674c098c132522272488a8e59e869b72d6640d03490fabef0fc13a61bb94

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 5.131.0 (2026-06-18)
+
+Full Changelog: [v5.130.1...v5.131.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.130.1...v5.131.0)
+
+### Features
+
+* add transcriptions-search API spec (dev/external) ([b1cda17](https://github.com/team-telnyx/telnyx-ruby/commit/b1cda17c4f29a9398b7a785b2e8cd3645ff80b63))
+
+## 5.130.1 (2026-06-16)
+
+Full Changelog: [v5.130.0...v5.130.1](https://github.com/team-telnyx/telnyx-ruby/compare/v5.130.0...v5.130.1)
+
+### Bug Fixes
+
+* **client:** send content-type header for requests with an omitted optional body ([b4e3271](https://github.com/team-telnyx/telnyx-ruby/commit/b4e327110e5529b70e53a7437223eee156597f78))
+
 ## 5.130.0 (2026-06-16)
 
 Full Changelog: [v5.129.0...v5.130.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.129.0...v5.130.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.130.0"
+gem "telnyx", "~> 5.131.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -70,7 +70,6 @@ module Telnyx
     # @return [Telnyx::Resources::AdvancedOrders]
     attr_reader :advanced_orders
 
-    # Generate text with LLMs
     # @return [Telnyx::Resources::AI]
     attr_reader :ai
 

data/lib/telnyx/internal/transport/base_client.rb

@@ -306,7 +306,10 @@ module Telnyx
               Telnyx::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
-          headers.delete("content-type") if body.nil?
+          # Generated methods always pass `req[:body]` for operations that define a
+          # request body, so only elide the content-type header when the operation
+          # has no body at all, not when an optional body param was omitted.
+          headers.delete("content-type") if body.nil? && !req.key?(:body)
 
           url = Telnyx::Internal::Util.join_parsed_uri(
             @base_url_components,

data/lib/telnyx/models/ai_search_conversation_histories_params.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AI#search_conversation_histories
+    class AISearchConversationHistoriesParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute q
+      #   Natural language search query. The text is embedded into a 1024-dimensional
+      #   vector and compared against indexed record chunks using kNN cosine similarity.
+      #
+      #   @return [String]
+      required :q, String
+
+      # @!attribute record_type
+      #   The type of records to search. Each record type is stored in a separate vector
+      #   index.
+      #
+      #   @return [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::RecordType]
+      required :record_type, enum: -> { Telnyx::AISearchConversationHistoriesParams::RecordType }
+
+      # @!attribute filter_document_id
+      #   Filter by document identifier (exact match). Populated for knowledge_base
+      #   records.
+      #
+      #   @return [String, nil]
+      optional :filter_document_id, String
+
+      # @!attribute filter_ingested_at_gte
+      #   Only include records ingested (chunked, embedded, and indexed) on or after this
+      #   ISO 8601 timestamp.
+      #
+      #   @return [Time, nil]
+      optional :filter_ingested_at_gte, Time
+
+      # @!attribute filter_ingested_at_lte
+      #   Only include records ingested (chunked, embedded, and indexed) on or before this
+      #   ISO 8601 timestamp.
+      #
+      #   @return [Time, nil]
+      optional :filter_ingested_at_lte, Time
+
+      # @!attribute filter_record_created_at_gte
+      #   Only include records whose original creation time is on or after this ISO 8601
+      #   timestamp.
+      #
+      #   @return [Time, nil]
+      optional :filter_record_created_at_gte, Time
+
+      # @!attribute filter_record_created_at_lte
+      #   Only include records whose original creation time is on or before this ISO 8601
+      #   timestamp.
+      #
+      #   @return [Time, nil]
+      optional :filter_record_created_at_lte, Time
+
+      # @!attribute filter_record_id
+      #   Filter to chunks belonging to a specific parent record (exact match).
+      #
+      #   @return [String, nil]
+      optional :filter_record_id, String
+
+      # @!attribute filter_region_in
+      #   Filter by the region stored on the record. Comma-separated to match multiple
+      #   regions (USA, DEU, AUS, UAE). Distinct from the `region` parameter, which
+      #   selects which cluster(s) are queried.
+      #
+      #   @return [String, nil]
+      optional :filter_region_in, String
+
+      # @!attribute filter_retention
+      #   Filter by retention policy (exact match). Filter-only: not returned in the
+      #   response body.
+      #
+      #   @return [String, nil]
+      optional :filter_retention, String
+
+      # @!attribute filter_user_id
+      #   Filter to records owned by a specific user (exact match).
+      #
+      #   @return [String, nil]
+      optional :filter_user_id, String
+
+      # @!attribute min_score
+      #   Minimum cosine similarity score threshold (0.0 to 1.0). Results below this
+      #   threshold are excluded.
+      #
+      #   @return [Float, nil]
+      optional :min_score, Float
+
+      # @!attribute region
+      #   Restrict search to a specific region's OpenSearch cluster. When omitted, all
+      #   regions are queried in parallel (fan-out) and results are merged by cosine
+      #   similarity score.
+      #
+      #   @return [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::Region, nil]
+      optional :region, enum: -> { Telnyx::AISearchConversationHistoriesParams::Region }
+
+      # @!attribute top_k
+      #   Maximum number of results to return. Defaults to 20, maximum 100.
+      #
+      #   @return [Integer, nil]
+      optional :top_k, Integer
+
+      # @!method initialize(q:, record_type:, filter_document_id: nil, filter_ingested_at_gte: nil, filter_ingested_at_lte: nil, filter_record_created_at_gte: nil, filter_record_created_at_lte: nil, filter_record_id: nil, filter_region_in: nil, filter_retention: nil, filter_user_id: nil, min_score: nil, region: nil, top_k: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AISearchConversationHistoriesParams} for more details.
+      #
+      #   @param q [String] Natural language search query. The text is embedded into a 1024-dimensional vect
+      #
+      #   @param record_type [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::RecordType] The type of records to search. Each record type is stored in a separate vector i
+      #
+      #   @param filter_document_id [String] Filter by document identifier (exact match). Populated for knowledge_base record
+      #
+      #   @param filter_ingested_at_gte [Time] Only include records ingested (chunked, embedded, and indexed) on or after this
+      #
+      #   @param filter_ingested_at_lte [Time] Only include records ingested (chunked, embedded, and indexed) on or before this
+      #
+      #   @param filter_record_created_at_gte [Time] Only include records whose original creation time is on or after this ISO 8601 t
+      #
+      #   @param filter_record_created_at_lte [Time] Only include records whose original creation time is on or before this ISO 8601
+      #
+      #   @param filter_record_id [String] Filter to chunks belonging to a specific parent record (exact match).
+      #
+      #   @param filter_region_in [String] Filter by the region stored on the record. Comma-separated to match multiple reg
+      #
+      #   @param filter_retention [String] Filter by retention policy (exact match). Filter-only: not returned in the respo
+      #
+      #   @param filter_user_id [String] Filter to records owned by a specific user (exact match).
+      #
+      #   @param min_score [Float] Minimum cosine similarity score threshold (0.0 to 1.0). Results below this thres
+      #
+      #   @param region [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::Region] Restrict search to a specific region's OpenSearch cluster. When omitted, all reg
+      #
+      #   @param top_k [Integer] Maximum number of results to return. Defaults to 20, maximum 100.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      # The type of records to search. Each record type is stored in a separate vector
+      # index.
+      module RecordType
+        extend Telnyx::Internal::Type::Enum
+
+        VOICE = :voice
+        MESSAGE = :message
+        AI_PIPELINE_STORAGE = :ai_pipeline_storage
+        KNOWLEDGE_BASE = :knowledge_base
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Restrict search to a specific region's OpenSearch cluster. When omitted, all
+      # regions are queried in parallel (fan-out) and results are merged by cosine
+      # similarity score.
+      module Region
+        extend Telnyx::Internal::Type::Enum
+
+        USA = :USA
+        DEU = :DEU
+        AUS = :AUS
+        UAE = :UAE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai_search_conversation_histories_response.rb

@@ -0,0 +1,233 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AI#search_conversation_histories
+    class AISearchConversationHistoriesResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #   Ranked list of matching text chunks, sorted by cosine similarity score
+      #   descending.
+      #
+      #   @return [Array<Telnyx::Models::AISearchConversationHistoriesResponse::Data>]
+      required :data,
+               -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AISearchConversationHistoriesResponse::Data] }
+
+      # @!attribute meta
+      #   Pagination metadata following the standard Telnyx V2 API format.
+      #
+      #   @return [Telnyx::Models::AISearchConversationHistoriesResponse::Meta]
+      required :meta, -> { Telnyx::Models::AISearchConversationHistoriesResponse::Meta }
+
+      # @!method initialize(data:, meta:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AISearchConversationHistoriesResponse} for more details.
+      #
+      #   Search response following the standard Telnyx V2 API format.
+      #
+      #   @param data [Array<Telnyx::Models::AISearchConversationHistoriesResponse::Data>] Ranked list of matching text chunks, sorted by cosine similarity score descendin
+      #
+      #   @param meta [Telnyx::Models::AISearchConversationHistoriesResponse::Meta] Pagination metadata following the standard Telnyx V2 API format.
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Unique chunk identifier.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute chunk_index
+        #   Zero-based index of this chunk within the parent record.
+        #
+        #   @return [Integer]
+        required :chunk_index, Integer
+
+        # @!attribute chunk_total
+        #   Total number of chunks the parent record was split into.
+        #
+        #   @return [Integer]
+        required :chunk_total, Integer
+
+        # @!attribute document_id
+        #   Document identifier. Present only for knowledge_base records; null for all other
+        #   record types.
+        #
+        #   @return [String, nil]
+        required :document_id, String, nil?: true
+
+        # @!attribute ingested_at
+        #   When the record was chunked, embedded, and indexed (ISO 8601).
+        #
+        #   @return [Time]
+        required :ingested_at, Time
+
+        # @!attribute organization_id
+        #   Identifier of the organization that owns this record.
+        #
+        #   @return [String]
+        required :organization_id, String
+
+        # @!attribute record_created_at
+        #   When the original record was created (ISO 8601).
+        #
+        #   @return [Time]
+        required :record_created_at, Time
+
+        # @!attribute record_id
+        #   Identifier of the parent record. Multiple chunks from the same record share this
+        #   ID.
+        #
+        #   @return [String]
+        required :record_id, String
+
+        # @!attribute record_type
+        #   Type of the record.
+        #
+        #   @return [Symbol, Telnyx::Models::AISearchConversationHistoriesResponse::Data::RecordType]
+        required :record_type,
+                 enum: -> { Telnyx::Models::AISearchConversationHistoriesResponse::Data::RecordType }
+
+        # @!attribute region
+        #   The region where this record is stored.
+        #
+        #   @return [Symbol, Telnyx::Models::AISearchConversationHistoriesResponse::Data::Region]
+        required :region, enum: -> { Telnyx::Models::AISearchConversationHistoriesResponse::Data::Region }
+
+        # @!attribute score
+        #   Cosine similarity score between the query vector and this chunk's vector. Higher
+        #   values indicate greater semantic relevance.
+        #
+        #   @return [Float]
+        required :score, Float
+
+        # @!attribute text
+        #   The text content of this chunk (up to 480 tokens).
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute user_id
+        #   Identifier of the user who owns this record.
+        #
+        #   @return [String]
+        required :user_id, String
+
+        # @!attribute metadata
+        #   Arbitrary metadata attached to the record at ingestion time. Stored as a
+        #   flat_object in OpenSearch and filterable via filter[field]=value query
+        #   parameters.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!method initialize(id:, chunk_index:, chunk_total:, document_id:, ingested_at:, organization_id:, record_created_at:, record_id:, record_type:, region:, score:, text:, user_id:, metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AISearchConversationHistoriesResponse::Data} for more details.
+        #
+        #   A single search result representing one chunk of a conversation history record.
+        #   Records are split into chunks of up to 480 tokens with 64-token overlap at
+        #   ingestion time.
+        #
+        #   @param id [String] Unique chunk identifier.
+        #
+        #   @param chunk_index [Integer] Zero-based index of this chunk within the parent record.
+        #
+        #   @param chunk_total [Integer] Total number of chunks the parent record was split into.
+        #
+        #   @param document_id [String, nil] Document identifier. Present only for knowledge_base records; null for all other
+        #
+        #   @param ingested_at [Time] When the record was chunked, embedded, and indexed (ISO 8601).
+        #
+        #   @param organization_id [String] Identifier of the organization that owns this record.
+        #
+        #   @param record_created_at [Time] When the original record was created (ISO 8601).
+        #
+        #   @param record_id [String] Identifier of the parent record. Multiple chunks from the same record share this
+        #
+        #   @param record_type [Symbol, Telnyx::Models::AISearchConversationHistoriesResponse::Data::RecordType] Type of the record.
+        #
+        #   @param region [Symbol, Telnyx::Models::AISearchConversationHistoriesResponse::Data::Region] The region where this record is stored.
+        #
+        #   @param score [Float] Cosine similarity score between the query vector and this chunk's vector. Higher
+        #
+        #   @param text [String] The text content of this chunk (up to 480 tokens).
+        #
+        #   @param user_id [String] Identifier of the user who owns this record.
+        #
+        #   @param metadata [Hash{Symbol=>Object}] Arbitrary metadata attached to the record at ingestion time. Stored as a flat_ob
+
+        # Type of the record.
+        #
+        # @see Telnyx::Models::AISearchConversationHistoriesResponse::Data#record_type
+        module RecordType
+          extend Telnyx::Internal::Type::Enum
+
+          VOICE = :voice
+          MESSAGE = :message
+          AI_PIPELINE_STORAGE = :ai_pipeline_storage
+          KNOWLEDGE_BASE = :knowledge_base
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The region where this record is stored.
+        #
+        # @see Telnyx::Models::AISearchConversationHistoriesResponse::Data#region
+        module Region
+          extend Telnyx::Internal::Type::Enum
+
+          USA = :USA
+          DEU = :DEU
+          AUS = :AUS
+          UAE = :UAE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @see Telnyx::Models::AISearchConversationHistoriesResponse#meta
+      class Meta < Telnyx::Internal::Type::BaseModel
+        # @!attribute page_number
+        #   Current page number (always 1 — this API does not support pagination, use top_k
+        #   instead).
+        #
+        #   @return [Integer]
+        required :page_number, Integer
+
+        # @!attribute page_size
+        #   Number of results per page (equals the effective top_k value).
+        #
+        #   @return [Integer]
+        required :page_size, Integer
+
+        # @!attribute total_pages
+        #   Total number of pages.
+        #
+        #   @return [Integer]
+        required :total_pages, Integer
+
+        # @!attribute total_results
+        #   Total number of matching results across all queried regions (before top_k
+        #   truncation).
+        #
+        #   @return [Integer]
+        required :total_results, Integer
+
+        # @!method initialize(page_number:, page_size:, total_pages:, total_results:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AISearchConversationHistoriesResponse::Meta} for more details.
+        #
+        #   Pagination metadata following the standard Telnyx V2 API format.
+        #
+        #   @param page_number [Integer] Current page number (always 1 — this API does not support pagination, use top_k
+        #
+        #   @param page_size [Integer] Number of results per page (equals the effective top_k value).
+        #
+        #   @param total_pages [Integer] Total number of pages.
+        #
+        #   @param total_results [Integer] Total number of matching results across all queried regions (before top_k trunca
+      end
+    end
+  end
+end

data/lib/telnyx/models.rb

@@ -87,6 +87,8 @@ module Telnyx
 
   AIRetrieveModelsParams = Telnyx::Models::AIRetrieveModelsParams
 
+  AISearchConversationHistoriesParams = Telnyx::Models::AISearchConversationHistoriesParams
+
   AISummarizeParams = Telnyx::Models::AISummarizeParams
 
   AlphanumericSenderID = Telnyx::Models::AlphanumericSenderID

data/lib/telnyx/resources/ai.rb

@@ -2,7 +2,6 @@
 
 module Telnyx
   module Resources
-    # Generate text with LLMs
     class AI
       # Configure AI assistant specifications
       # @return [Telnyx::Resources::AI::Assistants]
@@ -102,6 +101,118 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::AISearchConversationHistoriesParams} for more details.
+      #
+      # Performs semantic vector search across conversation history records.
+      #
+      # **How it works:**
+      #
+      # 1. The query text is embedded into a 1024-dimensional vector using the
+      #    multilingual-e5-large model.
+      # 2. The vector is sent to regional OpenSearch clusters for kNN search using HNSW
+      #    cosine similarity.
+      # 3. When no region is specified, all regions are queried in parallel (fan-out)
+      #    and results are merged by score.
+      # 4. Results are ranked by cosine similarity score (descending) and truncated to
+      #    `top_k`.
+      #
+      # **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+      # Results are automatically scoped to the caller's organization —
+      # `organization_id` is injected from the auth token and cannot be overridden.
+      #
+      # **Chunking:** Records are split into chunks of up to 480 tokens with 64-token
+      # overlap at ingestion time. Each search result represents a single chunk, with
+      # `chunk_index` and `chunk_total` indicating its position within the original
+      # record.
+      #
+      # **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+      # results before vector search.
+      #
+      # Top-level filterable fields: `user_id`, `record_type`, `region`, `document_id`,
+      # `record_id`, `record_created_at`, `ingested_at`, `retention`
+      #
+      # Note: `retention` is filter-only — it can be used to narrow results but is not
+      # returned in the response body.
+      #
+      # Metadata fields: any field not in the list above is resolved to
+      # `data.metadata.<field>` in OpenSearch (e.g., `filter[language]=en` →
+      # `data.metadata.language`).
+      #
+      # Supported filter operators:
+      #
+      # - `eq` — exact match (default when no operator specified)
+      # - `in` — match any of comma-separated values
+      # - `gte`, `gt`, `lte`, `lt` — range comparisons (useful for date filtering)
+      # - `contains` — wildcard substring match
+      #
+      # **Examples:**
+      #
+      # ```
+      # GET /v2/ai/conversation_histories?q=billing+issue&record_type=voice&top_k=10
+      # GET /v2/ai/conversation_histories?q=setup+guide&record_type=knowledge_base&region=USA&min_score=0.5
+      # GET /v2/ai/conversation_histories?q=refund&record_type=voice&filter[record_created_at][gte]=2026-01-01T00:00:00Z
+      # GET /v2/ai/conversation_histories?q=outage&record_type=voice&filter[region][in]=USA,DEU
+      # GET /v2/ai/conversation_histories?q=hold+time&record_type=voice&filter[language]=en
+      # ```
+      #
+      # @overload search_conversation_histories(q:, record_type:, filter_document_id: nil, filter_ingested_at_gte: nil, filter_ingested_at_lte: nil, filter_record_created_at_gte: nil, filter_record_created_at_lte: nil, filter_record_id: nil, filter_region_in: nil, filter_retention: nil, filter_user_id: nil, min_score: nil, region: nil, top_k: nil, request_options: {})
+      #
+      # @param q [String] Natural language search query. The text is embedded into a 1024-dimensional vect
+      #
+      # @param record_type [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::RecordType] The type of records to search. Each record type is stored in a separate vector i
+      #
+      # @param filter_document_id [String] Filter by document identifier (exact match). Populated for knowledge_base record
+      #
+      # @param filter_ingested_at_gte [Time] Only include records ingested (chunked, embedded, and indexed) on or after this
+      #
+      # @param filter_ingested_at_lte [Time] Only include records ingested (chunked, embedded, and indexed) on or before this
+      #
+      # @param filter_record_created_at_gte [Time] Only include records whose original creation time is on or after this ISO 8601 t
+      #
+      # @param filter_record_created_at_lte [Time] Only include records whose original creation time is on or before this ISO 8601
+      #
+      # @param filter_record_id [String] Filter to chunks belonging to a specific parent record (exact match).
+      #
+      # @param filter_region_in [String] Filter by the region stored on the record. Comma-separated to match multiple reg
+      #
+      # @param filter_retention [String] Filter by retention policy (exact match). Filter-only: not returned in the respo
+      #
+      # @param filter_user_id [String] Filter to records owned by a specific user (exact match).
+      #
+      # @param min_score [Float] Minimum cosine similarity score threshold (0.0 to 1.0). Results below this thres
+      #
+      # @param region [Symbol, Telnyx::Models::AISearchConversationHistoriesParams::Region] Restrict search to a specific region's OpenSearch cluster. When omitted, all reg
+      #
+      # @param top_k [Integer] Maximum number of results to return. Defaults to 20, maximum 100.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::AISearchConversationHistoriesResponse]
+      #
+      # @see Telnyx::Models::AISearchConversationHistoriesParams
+      def search_conversation_histories(params)
+        parsed, options = Telnyx::AISearchConversationHistoriesParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ai/conversation_histories",
+          query: query.transform_keys(
+            filter_document_id: "filter[document_id]",
+            filter_ingested_at_gte: "filter[ingested_at][gte]",
+            filter_ingested_at_lte: "filter[ingested_at][lte]",
+            filter_record_created_at_gte: "filter[record_created_at][gte]",
+            filter_record_created_at_lte: "filter[record_created_at][lte]",
+            filter_record_id: "filter[record_id]",
+            filter_region_in: "filter[region][in]",
+            filter_retention: "filter[retention]",
+            filter_user_id: "filter[user_id]"
+          ),
+          model: Telnyx::Models::AISearchConversationHistoriesResponse,
+          options: options
+        )
+      end
+
       # Generate a summary of a file's contents.
       #
       # Supports the following text formats:

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.130.0"
+  VERSION = "5.131.0"
 end

data/lib/telnyx.rb

@@ -402,6 +402,8 @@ require_relative "telnyx/models/ai_create_response_deprecated_params"
 require_relative "telnyx/models/ai_create_response_deprecated_response"
 require_relative "telnyx/models/ai_retrieve_models_params"
 require_relative "telnyx/models/ai_retrieve_models_response"
+require_relative "telnyx/models/ai_search_conversation_histories_params"
+require_relative "telnyx/models/ai_search_conversation_histories_response"
 require_relative "telnyx/models/ai_summarize_params"
 require_relative "telnyx/models/ai_summarize_response"
 require_relative "telnyx/models/alphanumeric_sender_id"

data/rbi/telnyx/client.rbi

@@ -65,7 +65,6 @@ module Telnyx
     sig { returns(Telnyx::Resources::AdvancedOrders) }
     attr_reader :advanced_orders
 
-    # Generate text with LLMs
     sig { returns(Telnyx::Resources::AI) }
     attr_reader :ai