telnyx 5.156.0 → 5.158.0

data/lib/telnyx/models/verify_profile_create_params.rb

@@ -254,7 +254,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -283,7 +283,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models/verify_profile_update_params.rb

@@ -216,7 +216,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -245,7 +245,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

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

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        class V1
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Anthropic::V1MessagesParams} for more details.
+          #
+          # Send a message to a language model using the Anthropic Messages API format. This
+          # endpoint is compatible with the
+          # [Anthropic Messages API](https://docs.anthropic.com/en/api/messages) and may be
+          # used with the Anthropic JS or Python SDK by setting the base URL to
+          # `https://api.telnyx.com/v2/ai/anthropic`.
+          #
+          # The endpoint translates Anthropic-format requests into Telnyx's inference
+          # internals, then translates the response back to the Anthropic message shape.
+          # Streaming responses use Anthropic SSE event types (`message_start`,
+          # `content_block_start`, `content_block_delta`, `content_block_stop`,
+          # `message_delta`, `message_stop`).
+          #
+          # @overload messages(max_tokens:, messages:, model:, api_key_ref: nil, billing_group_id: nil, fallback_config: nil, max_retries: nil, mcp_servers: nil, metadata: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, timeout: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, request_options: {})
+          #
+          # @param max_tokens [Integer] The maximum number of tokens to generate in the response.
+          #
+          # @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 api_key_ref [String] If you are using an external inference provider, this field allows you to pass a
+          #
+          # @param billing_group_id [String] The billing group ID to associate with this request.
+          #
+          # @param fallback_config [Hash{Symbol=>Object}] Configuration for model fallback behavior when the primary model is unavailable.
+          #
+          # @param max_retries [Integer] Maximum number of retries for the request.
+          #
+          # @param mcp_servers [Array<Hash{Symbol=>Object}>] List of MCP (Model Context Protocol) servers to make available to the model.
+          #
+          # @param metadata [Hash{Symbol=>Object}] An object describing metadata about the request.
+          #
+          # @param service_tier [String] Service tier for the request.
+          #
+          # @param stop_sequences [Array<String>] Custom sequences that will cause the model to stop generating.
+          #
+          # @param stream [Boolean] Whether to stream the response as Anthropic-format Server-Sent Events.
+          #
+          # @param system_ [String, Array<Hash{Symbol=>Object}>] System prompt. Can be a string or an array of content blocks following the Anthr
+          #
+          # @param temperature [Float] Amount of randomness injected into the response. Ranges from 0 to 1.
+          #
+          # @param thinking [Hash{Symbol=>Object}] Extended thinking configuration for models that support it. Set `type` to `enabl
+          #
+          # @param timeout [Float] Request timeout in seconds.
+          #
+          # @param tool_choice [Hash{Symbol=>Object}] Controls how the model uses tools, following the Anthropic API format.
+          #
+          # @param tools [Array<Hash{Symbol=>Object}>] Definitions of tools that the model may use, following the Anthropic API format.
+          #
+          # @param top_k [Integer] Top-k sampling parameter. Only sample from the top K options for each subsequent
+          #
+          # @param top_p [Float] Nucleus sampling parameter. Use temperature or top_p, but not both.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Hash{Symbol=>Object}]
+          #
+          # @see Telnyx::Models::AI::Anthropic::V1MessagesParams
+          def messages(params)
+            parsed, options = Telnyx::AI::Anthropic::V1MessagesParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "ai/anthropic/v1/messages",
+              body: parsed,
+              model: Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        # @return [Telnyx::Resources::AI::Anthropic::V1]
+        attr_reader :v1
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @v1 = Telnyx::Resources::AI::Anthropic::V1.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -97,7 +97,7 @@ module Telnyx
           #
           # @param tool_ids [Array<String>] Body param: IDs of shared tools to attach to the assistant. New integrations sho
           #
-          # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Body param: Deprecated for new integrations. Inline tool definitions available t
+          # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Body param: Deprecated for new integrations. Inline tool definitions available t
           #
           # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
           #

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

@@ -88,7 +88,7 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
@@ -202,7 +202,7 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+        # @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

data/lib/telnyx/resources/ai/conversations/conversation_insights.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Conversations
+        # Manage historical AI assistant conversations
+        class ConversationInsights
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams}
+          # for more details.
+          #
+          # Aggregate conversation insights by specified fields
+          #
+          # @overload retrieve_aggregates(created_at: nil, group_by: nil, insight_id: nil, metadata: nil, show: nil, request_options: {})
+          #
+          # @param created_at [String] Filter by creation datetime to scope the aggregation window. Supports range oper
+          #
+          # @param group_by [Array<String>] Fields to group by (can be comma-separated or multiple parameters). Prefix a fie
+          #
+          # @param insight_id [String] Optional insight ID to filter conversation insights. Only insights matching this
+          #
+          # @param metadata [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata]
+          #
+          # @param show [Array<String>] Fields to include in the result (can be comma-separated or multiple parameters).
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse]
+          #
+          # @see Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams
+          def retrieve_aggregates(params = {})
+            parsed, options =
+              Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "ai/conversations/conversation-insights/aggregates",
+              query: query,
+              model: Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/conversations.rb

@@ -17,6 +17,10 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Conversations::Messages]
         attr_reader :messages
 
+        # Manage historical AI assistant conversations
+        # @return [Telnyx::Resources::AI::Conversations::ConversationInsights]
+        attr_reader :conversation_insights
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::ConversationCreateParams} for more details.
         #
@@ -237,6 +241,7 @@ module Telnyx
           @insight_groups = Telnyx::Resources::AI::Conversations::InsightGroups.new(client: client)
           @insights = Telnyx::Resources::AI::Conversations::Insights.new(client: client)
           @messages = Telnyx::Resources::AI::Conversations::Messages.new(client: client)
+          @conversation_insights = Telnyx::Resources::AI::Conversations::ConversationInsights.new(client: client)
         end
       end
     end

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

@@ -7,7 +7,7 @@ module Telnyx
       class Tools
         # Create Tool
         #
-        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
+        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
         #
         # @param display_name [String]
         # @param type [String]
@@ -15,6 +15,7 @@ module Telnyx
         # @param function [Hash{Symbol=>Object}]
         # @param handoff [Hash{Symbol=>Object}]
         # @param invite [Hash{Symbol=>Object}]
+        # @param pay [Telnyx::Models::AI::PayToolParams]
         # @param retrieval [Hash{Symbol=>Object}]
         # @param timeout_ms [Integer]
         # @param webhook [Hash{Symbol=>Object}]
@@ -56,7 +57,7 @@ module Telnyx
 
         # Update Tool
         #
-        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
+        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
         #
         # @param tool_id [String] Unique identifier of the tool.
         #
@@ -70,6 +71,8 @@ module Telnyx
         #
         # @param invite [Hash{Symbol=>Object}]
         #
+        # @param pay [Telnyx::Models::AI::PayToolParams]
+        #
         # @param retrieval [Hash{Symbol=>Object}]
         #
         # @param timeout_ms [Integer]

data/lib/telnyx/resources/ai.rb

@@ -44,6 +44,9 @@ module Telnyx
       # @return [Telnyx::Resources::AI::Tools]
       attr_reader :tools
 
+      # @return [Telnyx::Resources::AI::Anthropic]
+      attr_reader :anthropic
+
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::AIRetrieveConversationHistoriesParams} for more details.
       #
@@ -208,6 +211,7 @@ module Telnyx
         @missions = Telnyx::Resources::AI::Missions.new(client: client)
         @openai = Telnyx::Resources::AI::OpenAI.new(client: client)
         @tools = Telnyx::Resources::AI::Tools.new(client: client)
+        @anthropic = Telnyx::Resources::AI::Anthropic.new(client: client)
       end
     end
   end

data/lib/telnyx/resources/calls.rb

@@ -35,7 +35,7 @@ module Telnyx
       # When the `record` parameter is set to `record-from-answer`, the response will
       # include a `recording_id` field.
       #
-      # @overload dial(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
+      # @overload dial(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, retry_on_timeout: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
       #
       # @param connection_id [String] The ID of the Call Control App (formerly ID of the connection) to be used when d
       #
@@ -105,6 +105,8 @@ module Telnyx
       #
       # @param record_trim [Symbol, Telnyx::Models::CallDialParams::RecordTrim] When set to `trim-silence`, silence will be removed from the beginning and end o
       #
+      # @param retry_on_timeout [Boolean] Whether to keep trying the remaining routing paths (e.g. alternate providers/gat
+      #
       # @param send_digits_on_answer [String] DTMF digits to send automatically after the called party answers. Useful for rea
       #
       # @param send_silence_when_idle [Boolean] Generate silence RTP packets when no transmission available.

data/lib/telnyx/resources/requirements.rb

@@ -4,23 +4,31 @@ module Telnyx
   module Resources
     # Requirements for international numbers and porting orders
     class Requirements
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::RequirementRetrieveParams} for more details.
+      #
       # Retrieve a document requirement record
       #
-      # @overload retrieve(id, request_options: {})
+      # @overload retrieve(id, version: nil, request_options: {})
       #
       # @param id [String] Uniquely identifies the requirement_type record
       #
+      # @param version [Integer] Filter by requirement version number. When omitted, returns the currently-active
+      #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Telnyx::Models::RequirementRetrieveResponse]
       #
       # @see Telnyx::Models::RequirementRetrieveParams
       def retrieve(id, params = {})
+        parsed, options = Telnyx::RequirementRetrieveParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["requirements/%1$s", id],
+          query: query,
           model: Telnyx::Models::RequirementRetrieveResponse,
-          options: params[:request_options]
+          options: options
         )
       end
 
@@ -29,7 +37,7 @@ module Telnyx
       #
       # List all requirements with filtering, sorting, and pagination
       #
-      # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
+      # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, version: nil, request_options: {})
       #
       # @param filter [Telnyx::Models::RequirementListParams::Filter] Consolidated filter parameter for requirements (deepObject style). Originally: f
       #
@@ -39,6 +47,8 @@ module Telnyx
       #
       # @param sort [Array<Symbol, Telnyx::Models::RequirementListParams::Sort>] Consolidated sort parameter for requirements (deepObject style). Originally: sor
       #
+      # @param version [Integer] Filter by requirement version number. When omitted, returns the currently-active
+      #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::DocReqsRequirement>]

data/lib/telnyx/resources/storage/cloudfs/actions.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Storage
+      class Cloudfs
+        # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+        # Cloud Storage
+        class Actions
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Storage::Cloudfs::ActionRotateMetaTokenParams} for more
+          # details.
+          #
+          # Issues a new metadata access token for the filesystem and returns the full
+          # filesystem, including the new `meta_token` and credential-bearing `meta_url`.
+          # The previous token stops authenticating immediately; the metadata database and
+          # S3 bucket are unchanged. The request takes no body. Allowed while the filesystem
+          # is `ready` or `needs_format`; otherwise returns a `409`. Retrying with the same
+          # `Idempotency-Key` within 24 hours replays the original response — including the
+          # same token — instead of rotating again.
+          #
+          # @overload rotate_meta_token(id, idempotency_key:, request_options: {})
+          #
+          # @param id [String] CloudFS filesystem ID
+          #
+          # @param idempotency_key [String] Unique key that makes the request idempotent (1-255 characters: letters, numbers
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper]
+          #
+          # @see Telnyx::Models::Storage::Cloudfs::ActionRotateMetaTokenParams
+          def rotate_meta_token(id, params)
+            parsed, options = Telnyx::Storage::Cloudfs::ActionRotateMetaTokenParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["storage/cloudfs/%1$s/actions/rotate-meta-token", id],
+              headers: parsed.transform_keys(idempotency_key: "idempotency-key"),
+              model: Telnyx::Storage::CloudfsFilesystemResponseWrapper,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/storage/cloudfs.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Storage
+      # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+      # Cloud Storage
+      class Cloudfs
+        # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+        # Cloud Storage
+        # @return [Telnyx::Resources::Storage::Cloudfs::Actions]
+        attr_reader :actions
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Storage::CloudfCreateParams} for more details.
+        #
+        # Creates a CloudFS filesystem. Provisioning is synchronous — typically a few
+        # seconds, up to a few minutes — and the filesystem is returned with status
+        # `ready`, together with its S3 bucket and metadata connection details. This
+        # response is the only time the filesystem's `meta_token` — and the
+        # credential-bearing `meta_url` — are returned; store them securely. If the token
+        # is lost, issue a new one with the rotate-meta-token action. Names are unique
+        # within your organization: creating with an existing name returns a `422`.
+        # Requests are idempotent: retrying with the same `Idempotency-Key` within 24
+        # hours replays the original response instead of creating another filesystem.
+        #
+        # @overload create(name:, region:, idempotency_key:, request_options: {})
+        #
+        # @param name [String] Body param: Filesystem name, unique within your organization. Names are trimmed
+        #
+        # @param region [Symbol, Telnyx::Models::Storage::CloudfCreateParams::Region] Body param: Region where the filesystem's storage and metadata are provisioned.
+        #
+        # @param idempotency_key [String] Header param: Unique key that makes the request idempotent (1-255 characters: le
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::CloudfCreateParams
+        def create(params)
+          parsed, options = Telnyx::Storage::CloudfCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: "storage/cloudfs",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::Storage::CloudfsFilesystemResponseWrapper,
+            options: options
+          )
+        end
+
+        # Retrieves a CloudFS filesystem by its ID. The returned `meta_url` omits the
+        # credential — the metadata token is only ever returned by create and
+        # rotate-meta-token. A filesystem whose last lifecycle action failed includes a
+        # customer-safe `error` message.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] CloudFS filesystem ID
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::CloudfRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["storage/cloudfs/%1$s", id],
+            model: Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Storage::CloudfUpdateParams} for more details.
+        #
+        # Updates a CloudFS filesystem. Only `name` can be changed; other fields are
+        # immutable and unknown fields are rejected with a `400`. Renaming to a name that
+        # already exists in your organization returns a `422`.
+        #
+        # @overload update(id, name: nil, request_options: {})
+        #
+        # @param id [String] CloudFS filesystem ID
+        #
+        # @param name [String] New filesystem name, unique within your organization. Names are trimmed and lowe
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::CloudfUpdateParams
+        def update(id, params = {})
+          parsed, options = Telnyx::Storage::CloudfUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["storage/cloudfs/%1$s", id],
+            body: parsed,
+            model: Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Storage::CloudfListParams} for more details.
+        #
+        # Lists the CloudFS filesystems for the authenticated user's organization. Results
+        # use cursor-based pagination: fetch the next page by passing `meta.cursors.after`
+        # as `page[after]`, or follow the `meta.next` URL.
+        #
+        # @overload list(filter_name: nil, filter_region: nil, filter_status: nil, page_after: nil, page_before: nil, page_limit: nil, sort: nil, request_options: {})
+        #
+        # @param filter_name [String] Return only the filesystem whose name matches exactly.
+        #
+        # @param filter_region [String] Return only filesystems in this region.
+        #
+        # @param filter_status [Symbol, Telnyx::Models::Storage::CloudfListParams::FilterStatus] Return only filesystems with this status. Unrecognized values are ignored.
+        #
+        # @param page_after [String] Opaque cursor from a previous response's `meta.cursors.after`; returns the page
+        #
+        # @param page_before [String] Opaque cursor from a previous response's `meta.cursors.before`; returns the page
+        #
+        # @param page_limit [Integer] The number of filesystems to return per page. Values above 250 are treated as 25
+        #
+        # @param sort [Symbol, Telnyx::Models::Storage::CloudfListParams::Sort] Sort order for the results: a field name for ascending, or the field name prefix
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::CloudfListResponse]
+        #
+        # @see Telnyx::Models::Storage::CloudfListParams
+        def list(params = {})
+          parsed, options = Telnyx::Storage::CloudfListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "storage/cloudfs",
+            query: query.transform_keys(
+              filter_name: "filter[name]",
+              filter_region: "filter[region]",
+              filter_status: "filter[status]",
+              page_after: "page[after]",
+              page_before: "page[before]",
+              page_limit: "page[limit]"
+            ),
+            model: Telnyx::Models::Storage::CloudfListResponse,
+            options: options
+          )
+        end
+
+        # Permanently deletes a CloudFS filesystem, removing its S3 bucket and its
+        # metadata database. Deletion is synchronous: the response returns the
+        # filesystem's final state with status `deleted`. There is no restore. A
+        # filesystem that is still `provisioning` returns a `409`. If the filesystem still
+        # contains data, the request may be rejected with a `409` — drain the bucket and
+        # retry.
+        #
+        # @overload delete(id, request_options: {})
+        #
+        # @param id [String] CloudFS filesystem ID
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::CloudfsFilesystemDetailResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::CloudfDeleteParams
+        def delete(id, params = {})
+          @client.request(
+            method: :delete,
+            path: ["storage/cloudfs/%1$s", id],
+            model: Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @actions = Telnyx::Resources::Storage::Cloudfs::Actions.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/storage.rb

@@ -20,6 +20,11 @@ module Telnyx
       # @return [Telnyx::Resources::Storage::Kvs]
       attr_reader :kvs
 
+      # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+      # Cloud Storage
+      # @return [Telnyx::Resources::Storage::Cloudfs]
+      attr_reader :cloudfs
+
       # List Migration Source coverage
       #
       # @overload list_migration_source_coverage(request_options: {})
@@ -47,6 +52,7 @@ module Telnyx
         @migration_sources = Telnyx::Resources::Storage::MigrationSources.new(client: client)
         @migrations = Telnyx::Resources::Storage::Migrations.new(client: client)
         @kvs = Telnyx::Resources::Storage::Kvs.new(client: client)
+        @cloudfs = Telnyx::Resources::Storage::Cloudfs.new(client: client)
       end
     end
   end

data/lib/telnyx/version.rb

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