telnyx 5.162.0 → 5.164.0

data/rbi/telnyx/resources/ai/assistants.rbi

@@ -33,7 +33,8 @@ module Telnyx
         sig { returns(Telnyx::Resources::AI::Assistants::Instructions) }
         attr_reader :instructions
 
-        # Create a new AI Assistant.
+        # Creates a new AI assistant from the provided configuration, including its model,
+        # instructions, and attached tools, and returns the created assistant.
         sig do
           params(
             instructions: String,
@@ -83,101 +84,124 @@ module Telnyx
             transcription: Telnyx::AI::TranscriptionSettings::OrHash,
             voice_settings: Telnyx::AI::VoiceSettings::OrHash,
             widget_settings: Telnyx::AI::WidgetSettings::OrHash,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::InferenceEmbedding)
         end
         def create(
-          # System instructions for the assistant. These may be templated with
+          # Body param: System instructions for the assistant. These may be templated with
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
           instructions:,
+          # Body param
           name:,
-          # Conversation flow as supplied by API clients (create / update).
+          # Body param: Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
           # unique node/edge IDs, that `start_node_id` references a real node, and that
           # every edge's endpoints reference real nodes.
           conversation_flow: nil,
+          # Body param
           description: nil,
-          # Map of dynamic variables and their default values
+          # Body param: Map of dynamic variables and their default values
           dynamic_variables: nil,
-          # Timeout in milliseconds for the dynamic variables webhook. Must be between 1 and
-          # 10000 ms. If the webhook does not respond within this timeout, the call proceeds
-          # with default values. See the
+          # Body param: Timeout in milliseconds for the dynamic variables webhook. Must be
+          # between 1 and 10000 ms. If the webhook does not respond within this timeout, the
+          # call proceeds with default values. See the
           # [dynamic variables guide](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
           dynamic_variables_webhook_timeout_ms: nil,
-          # If `dynamic_variables_webhook_url` is set, Telnyx sends a POST request to this
-          # URL at the start of the conversation to resolve dynamic variables. **Gotcha:**
-          # the webhook response must wrap variables under a top-level `dynamic_variables`
-          # object, e.g. `{"dynamic_variables": {"customer_name": "Jane"}}`. Returning a
-          # flat object will be ignored and variables will fall back to their defaults. See
-          # the
+          # Body param: If `dynamic_variables_webhook_url` is set, Telnyx sends a POST
+          # request to this URL at the start of the conversation to resolve dynamic
+          # variables. **Gotcha:** the webhook response must wrap variables under a
+          # top-level `dynamic_variables` object, e.g.
+          # `{"dynamic_variables": {"customer_name": "Jane"}}`. Returning a flat object will
+          # be ignored and variables will fall back to their defaults. See the
           # [dynamic variables guide](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
           # for the full request/response format and timeout behavior.
           dynamic_variables_webhook_url: nil,
+          # Body param
           enabled_features: nil,
+          # Body param
           external_llm: nil,
+          # Body param
           fallback_config: nil,
-          # Text that the assistant will use to start the conversation. This may be
-          # templated with
+          # Body param: Text that the assistant will use to start the conversation. This may
+          # be templated with
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
           # Use an empty string to have the assistant wait for the user to speak first. Use
           # the special value `<assistant-speaks-first-with-model-generated-message>` to
           # have the assistant generate the greeting based on the system instructions.
           greeting: nil,
+          # Body param
           insight_settings: nil,
-          # Connected integrations attached to the assistant. The catalog of available
-          # integrations is at `/ai/integrations`; the user's connected integrations are at
-          # `/ai/integrations/connections`. Each item references a catalog integration by
-          # `integration_id`.
+          # Body param: Connected integrations attached to the assistant. The catalog of
+          # available integrations is at `/ai/integrations`; the user's connected
+          # integrations are at `/ai/integrations/connections`. Each item references a
+          # catalog integration by `integration_id`.
           integrations: nil,
-          # Settings for interruptions and how the assistant decides the user has finished
-          # speaking. These timings are most relevant when using non turn-taking
-          # transcription models. For turn-taking models like `deepgram/flux`, end-of-turn
-          # behavior is controlled by the transcription end-of-turn settings under
-          # `transcription.settings` (`eot_threshold`, `eot_timeout_ms`,
+          # Body param: Settings for interruptions and how the assistant decides the user
+          # has finished speaking. These timings are most relevant when using non
+          # turn-taking transcription models. For turn-taking models like `deepgram/flux`,
+          # end-of-turn behavior is controlled by the transcription end-of-turn settings
+          # under `transcription.settings` (`eot_threshold`, `eot_timeout_ms`,
           # `eager_eot_threshold`).
           interruption_settings: nil,
-          # This is only needed when using third-party inference providers selected by
-          # `model`. The `identifier` for an integration secret
+          # Body param: This is only needed when using third-party inference providers
+          # selected by `model`. The `identifier` for an integration secret
           # [/v2/integration_secrets](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
           # that refers to your LLM provider's API key. For bring-your-own endpoint
           # authentication, use `external_llm.llm_api_key_ref` instead. Warning: Free plans
           # are unlikely to work with this integration.
           llm_api_key_ref: nil,
-          # MCP servers attached to the assistant. Create MCP servers with
+          # Body param: MCP servers attached to the assistant. Create MCP servers with
           # `/ai/mcp_servers`, then reference them by `id` here.
           mcp_servers: nil,
+          # Body param
           messaging_settings: nil,
-          # ID of the model to use when `external_llm` is not set. You can use the
+          # Body param: ID of the model to use when `external_llm` is not set. You can use
+          # the
           # [Get models API](https://developers.telnyx.com/api-reference/openai-chat/get-available-models-openai-compatible)
           # to see available models. If `external_llm` is provided, the assistant uses
           # `external_llm` instead of this field. If neither `model` nor `external_llm` is
           # provided, Telnyx applies the default model.
           model: nil,
+          # Body param
           observability_settings: nil,
-          # Configuration for post-conversation processing. When enabled, the assistant
-          # receives one additional LLM turn after the conversation ends, allowing it to
-          # execute tool calls such as logging to a CRM or sending a summary. The assistant
-          # can execute multiple parallel or sequential tools during this phase.
+          # Body param: Configuration for post-conversation processing. When enabled, the
+          # assistant receives one additional LLM turn after the conversation ends, allowing
+          # it to execute tool calls such as logging to a CRM or sending a summary. The
+          # assistant can execute multiple parallel or sequential tools during this phase.
           # Telephony-control tools (e.g. hangup, transfer) are unavailable
           # post-conversation. Beta feature.
           post_conversation_settings: nil,
+          # Body param
           privacy_settings: nil,
-          # Tags associated with the assistant. Tags can also be managed with the assistant
-          # tag endpoints.
+          # Body param: Tags associated with the assistant. Tags can also be managed with
+          # the assistant tag endpoints.
           tags: nil,
+          # Body param
           telephony_settings: nil,
-          # IDs of shared tools to attach to the assistant. New integrations should prefer
-          # `tool_ids` over inline `tools`.
+          # Body param: IDs of shared tools to attach to the assistant. New integrations
+          # should prefer `tool_ids` over inline `tools`.
           tool_ids: nil,
-          # Deprecated for new integrations. Inline tool definitions available to the
-          # assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-          # endpoints.
+          # Body param: Deprecated for new integrations. Inline tool definitions available
+          # to the assistant. Prefer `tool_ids` to attach shared tools created with the AI
+          # Tools endpoints.
           tools: nil,
+          # Body param
           transcription: nil,
+          # Body param
           voice_settings: nil,
-          # Configuration settings for the assistant's web widget.
+          # Body param: Configuration settings for the assistant's web widget.
           widget_settings: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -208,7 +232,9 @@ module Telnyx
         )
         end
 
-        # Update an AI Assistant's attributes.
+        # Updates the specified AI assistant's attributes and returns the updated
+        # assistant. The request can also control how the change is promoted across
+        # assistant versions.
         sig do
           params(
             assistant_id: String,
@@ -431,12 +457,22 @@ module Telnyx
         sig do
           params(
             assistant_id: String,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::InferenceEmbedding)
         end
         def clone_(
           # Unique identifier of the assistant.
           assistant_id,
+          # Optional opaque, unquoted key for safely retrying the same logical request. Keys
+          # must contain 1 to 255 letters, numbers, hyphens, or underscores. Generate a
+          # unique UUID v4 for each operation and reuse it only when retrying that operation
+          # with the same request. Invalid headers—including duplicate, empty, malformed, or
+          # overlong values—return 400 with error code 10015. A request already in progress
+          # with the same key returns 409; reusing the key with a different request
+          # returns 422. Only successful responses are replayed, for up to 24 hours. Do not
+          # include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -463,19 +499,29 @@ module Telnyx
             api_key_ref: String,
             provider: Telnyx::AI::AssistantImportsParams::Provider::OrSymbol,
             import_ids: T::Array[String],
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::AssistantsList)
         end
         def imports(
-          # Integration secret pointer that refers to the API key for the external provider.
-          # This should be an identifier for an integration secret created via
-          # /v2/integration_secrets.
+          # Body param: Integration secret pointer that refers to the API key for the
+          # external provider. This should be an identifier for an integration secret
+          # created via /v2/integration_secrets.
           api_key_ref:,
-          # The external provider to import assistants from.
+          # Body param: The external provider to import assistants from.
           provider:,
-          # Optional list of assistant IDs to import from the external provider. If not
-          # provided, all assistants will be imported.
+          # Body param: Optional list of assistant IDs to import from the external provider.
+          # If not provided, all assistants will be imported.
           import_ids: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -503,17 +549,32 @@ module Telnyx
               ],
             should_create_conversation: T::Boolean,
             text: String,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::AI::AssistantSendSMSResponse)
         end
         def send_sms(
-          # Unique identifier of the assistant.
+          # Path param: Unique identifier of the assistant.
           assistant_id,
+          # Body param
           from:,
+          # Body param
           to:,
+          # Body param
           conversation_metadata: nil,
+          # Body param
           should_create_conversation: nil,
+          # Body param
           text: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end

data/rbi/telnyx/resources/ai/collections/sources.rbi

@@ -7,7 +7,9 @@ module Telnyx
         # Create and manage logical collections of your Telnyx data, tune retrieval
         # settings, manage sources, and run collection-scoped semantic search.
         class Sources
-          # Attaches a new source to a collection.
+          # Attaches a new content source to the specified collection and returns the
+          # created source. The source's content is ingested and embedded so it becomes
+          # searchable within the collection.
           sig do
             params(
               uuid: String,

data/rbi/telnyx/resources/ai/collections.rbi

@@ -125,79 +125,6 @@ module Telnyx
         )
         end
 
-        # Runs search over the documents in a collection, ranked by relevance to `query`.
-        # The collection's `retrieval_type` setting selects the strategy: `vector`
-        # (semantic similarity), `hybrid` (vector similarity fused with keyword matching),
-        # or `keyword` (lexical BM25 matching). When `query` is omitted, returns a plain
-        # catalog listing of the collection's documents.
-        #
-        # **How it works:**
-        #
-        # 1. For `vector` and `hybrid`, the `query` text is embedded into a
-        #    1024-dimensional vector using the multilingual-e5-large model.
-        # 2. For `vector`, the embedding is compared against the collection's indexed
-        #    document chunks using semantic similarity; for `hybrid`, those similarity
-        #    scores are fused with keyword-match scores; for `keyword`, only lexical BM25
-        #    matching is applied.
-        # 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
-        #    `page[size]`.
-        #
-        # **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
-        # Results are automatically scoped to your organization and cannot be overridden.
-        #
-        # **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
-        # results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
-        # `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
-        #
-        # **Examples:**
-        #
-        # - `GET /v2/ai/collections/my-collection/documents?query=billing+issue&top_k=10`
-        # - `GET /v2/ai/collections/my-collection/documents?query=refund&sources=voice,message`
-        # - `GET /v2/ai/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
-        sig do
-          params(
-            slug: String,
-            filter: T::Hash[Symbol, T.anything],
-            page_number: Integer,
-            page_size: Integer,
-            query: String,
-            retrieval_type:
-              Telnyx::AI::CollectionRetrieveDocumentsParams::RetrievalType::OrSymbol,
-            sources: String,
-            top_k: Integer,
-            request_options: Telnyx::RequestOptions::OrHash
-          ).returns(Telnyx::Models::AI::CollectionRetrieveDocumentsResponse)
-        end
-        def retrieve_documents(
-          # The collection's slug (unique within your organization).
-          slug,
-          # Field filters applied before ranking, using `filter[field][operator]=value`.
-          # Supported operators: `eq` (default), `in`, `gte`, `gt`, `lte`, `lt`, `contains`.
-          # Known fields: `record_type`, `record_id`, `user_id`, `record_created_at`,
-          # `ingested_at`; any other name resolves to a `metadata.<field>` filter. Example:
-          # `filter[record_id][eq]=rec_123`.
-          filter: nil,
-          # Page number to return (1-based). Defaults to 1.
-          page_number: nil,
-          # Number of results per page. Defaults to 20.
-          page_size: nil,
-          # Natural-language search query. When provided, the text is matched against the
-          # collection's document chunks using the collection's `retrieval_type` (vector or
-          # hybrid). When omitted, documents are returned as a plain catalog listing.
-          query: nil,
-          # Override the collection's configured retrieval strategy for this request. Echoed
-          # back in `meta.retrieval_type`.
-          retrieval_type: nil,
-          # Comma-separated list of source types to restrict the search to. When omitted,
-          # all of the collection's sources are searched.
-          sources: nil,
-          # Maximum number of ranked results to consider. When omitted, the collection's
-          # configured `top_k` setting is used.
-          top_k: nil,
-          request_options: {}
-        )
-        end
-
         # @api private
         sig { params(client: Telnyx::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/telnyx/resources/ai/conversations/insight_groups/insights.rbi

@@ -7,7 +7,7 @@ module Telnyx
         class InsightGroups
           # Manage historical AI assistant conversations
           class Insights
-            # Assign an insight to a group
+            # Assigns the specified insight template to the specified insight template group.
             sig do
               params(
                 insight_id: String,
@@ -24,7 +24,8 @@ module Telnyx
             )
             end
 
-            # Remove an insight from a group
+            # Removes the specified insight template from the specified group. The insight
+            # template itself is not deleted.
             sig do
               params(
                 insight_id: String,

data/rbi/telnyx/resources/ai/conversations/insight_groups.rbi

@@ -14,7 +14,8 @@ module Telnyx
           end
           attr_reader :insights
 
-          # Get insight group by ID
+          # Returns the details of a single insight template group, including the insight
+          # templates assigned to it.
           sig do
             params(
               group_id: String,
@@ -28,7 +29,7 @@ module Telnyx
           )
           end
 
-          # Update an insight template group
+          # Updates the specified insight template group and returns the updated group.
           sig do
             params(
               group_id: String,
@@ -48,7 +49,7 @@ module Telnyx
           )
           end
 
-          # Delete insight group by ID
+          # Permanently deletes the specified insight template group by its ID.
           sig do
             params(
               group_id: String,
@@ -62,24 +63,40 @@ module Telnyx
           )
           end
 
-          # Create a new insight group
+          # Creates a new insight template group for organizing related insight templates,
+          # and returns the created group.
           sig do
             params(
               name: String,
               description: String,
               webhook: String,
+              idempotency_key: String,
               request_options: Telnyx::RequestOptions::OrHash
             ).returns(Telnyx::AI::Conversations::InsightTemplateGroupDetail)
           end
           def insight_groups(
+            # Body param
             name:,
+            # Body param
             description: nil,
+            # Body param
             webhook: nil,
+            # Header param: Optional opaque, unquoted key for safely retrying the same logical
+            # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+            # Generate a unique UUID v4 for each operation and reuse it only when retrying
+            # that operation with the same request. Invalid headers—including duplicate,
+            # empty, malformed, or overlong values—return 400 with error code 10015. A request
+            # already in progress with the same key returns 409; reusing the key with a
+            # different request returns 422. Only successful responses are replayed, for up to
+            # 24 hours. Do not include sensitive data in the key.
+            idempotency_key: nil,
             request_options: {}
           )
           end
 
-          # Get all insight groups
+          # Returns a paginated list of your insight template groups. Groups organize
+          # related insight templates that are applied together when analyzing
+          # conversations.
           sig do
             params(
               page_number: Integer,

data/rbi/telnyx/resources/ai/conversations/insights.rbi

@@ -6,7 +6,8 @@ module Telnyx
       class Conversations
         # Manage historical AI assistant conversations
         class Insights
-          # Create a new insight
+          # Creates a new insight template defining an analysis to run over conversations,
+          # and returns the created template.
           sig do
             params(
               instructions: String,
@@ -14,20 +15,34 @@ module Telnyx
               json_schema:
                 Telnyx::AI::Conversations::InsightCreateParams::JsonSchema::Variants,
               webhook: String,
+              idempotency_key: String,
               request_options: Telnyx::RequestOptions::OrHash
             ).returns(Telnyx::AI::Conversations::InsightTemplateDetail)
           end
           def create(
+            # Body param
             instructions:,
+            # Body param
             name:,
-            # If specified, the output will follow the JSON schema.
+            # Body param: If specified, the output will follow the JSON schema.
             json_schema: nil,
+            # Body param
             webhook: nil,
+            # Header param: Optional opaque, unquoted key for safely retrying the same logical
+            # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+            # Generate a unique UUID v4 for each operation and reuse it only when retrying
+            # that operation with the same request. Invalid headers—including duplicate,
+            # empty, malformed, or overlong values—return 400 with error code 10015. A request
+            # already in progress with the same key returns 409; reusing the key with a
+            # different request returns 422. Only successful responses are replayed, for up to
+            # 24 hours. Do not include sensitive data in the key.
+            idempotency_key: nil,
             request_options: {}
           )
           end
 
-          # Get insight by ID
+          # Returns the details of a single insight template by its ID, including its
+          # configuration.
           sig do
             params(
               insight_id: String,
@@ -41,7 +56,7 @@ module Telnyx
           )
           end
 
-          # Update an insight template
+          # Updates the specified insight template and returns the updated template.
           sig do
             params(
               insight_id: String,
@@ -64,7 +79,8 @@ module Telnyx
           )
           end
 
-          # Get all insights
+          # Returns a paginated list of your insight templates. Insight templates define
+          # analyses that run over AI conversations to extract structured findings.
           sig do
             params(
               page_number: Integer,
@@ -79,7 +95,7 @@ module Telnyx
           def list(page_number: nil, page_size: nil, request_options: {})
           end
 
-          # Delete insight by ID
+          # Permanently deletes the specified insight template by its ID.
           sig do
             params(
               insight_id: String,

data/rbi/telnyx/resources/ai/conversations.rbi

@@ -23,19 +23,31 @@ module Telnyx
         end
         attr_reader :conversation_insights
 
-        # Create a new AI Conversation.
+        # Creates a new AI conversation, the container for messages exchanged with an
+        # assistant, and returns the created conversation.
         sig do
           params(
             metadata: T::Hash[Symbol, String],
             name: String,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::Conversation)
         end
         def create(
-          # Metadata associated with the conversation. Set `ai_disabled` to `true` to create
-          # the conversation with AI message responses disabled.
+          # Body param: Metadata associated with the conversation. Set `ai_disabled` to
+          # `true` to create the conversation with AI message responses disabled.
           metadata: nil,
+          # Body param
           name: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -161,20 +173,38 @@ module Telnyx
             tool_calls: T::Array[T::Hash[Symbol, T.anything]],
             tool_choice:
               Telnyx::AI::ConversationAddMessageParams::ToolChoice::Variants,
+            idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).void
         end
         def add_message(
-          # The ID of the conversation
+          # Path param: The ID of the conversation
           conversation_id,
+          # Body param
           role:,
+          # Body param
           content: nil,
+          # Body param
           metadata: nil,
+          # Body param
           name: nil,
+          # Body param
           sent_at: nil,
+          # Body param
           tool_call_id: nil,
+          # Body param
           tool_calls: nil,
+          # Body param
           tool_choice: nil,
+          # Header param: Optional opaque, unquoted key for safely retrying the same logical
+          # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+          # Generate a unique UUID v4 for each operation and reuse it only when retrying
+          # that operation with the same request. Invalid headers—including duplicate,
+          # empty, malformed, or overlong values—return 400 with error code 10015. A request
+          # already in progress with the same key returns 409; reusing the key with a
+          # different request returns 422. Only successful responses are replayed, for up to
+          # 24 hours. Do not include sensitive data in the key.
+          idempotency_key: nil,
           request_options: {}
         )
         end

data/rbi/telnyx/resources/ai/embeddings/buckets.rbi

@@ -21,7 +21,8 @@ module Telnyx
           )
           end
 
-          # Get all embedding buckets for a user.
+          # Returns the list of storage buckets that have been embedded for your account,
+          # for use with similarity search.
           sig do
             params(request_options: Telnyx::RequestOptions::OrHash).returns(
               Telnyx::Models::AI::Embeddings::BucketListResponse