telnyx 5.156.0 → 5.157.0

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.157.0"
 end

data/lib/telnyx.rb

@@ -137,6 +137,8 @@ require_relative "telnyx/models/advanced_order_list_params"
 require_relative "telnyx/models/advanced_order_list_response"
 require_relative "telnyx/models/advanced_order_retrieve_params"
 require_relative "telnyx/models/advanced_order_update_requirement_group_params"
+require_relative "telnyx/models/ai/anthropic/v1_messages_params"
+require_relative "telnyx/models/ai/anthropic/v1_messages_response"
 require_relative "telnyx/models/ai/arithmetic_expression"
 require_relative "telnyx/models/ai/assistant"
 require_relative "telnyx/models/ai/assistant_chat_params"
@@ -242,6 +244,8 @@ require_relative "telnyx/models/ai/conversation_retrieve_conversations_insights_
 require_relative "telnyx/models/ai/conversation_retrieve_conversations_insights_response"
 require_relative "telnyx/models/ai/conversation_retrieve_params"
 require_relative "telnyx/models/ai/conversation_retrieve_response"
+require_relative "telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_params"
+require_relative "telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_response"
 require_relative "telnyx/models/ai/conversations/insight_create_params"
 require_relative "telnyx/models/ai/conversations/insight_delete_params"
 require_relative "telnyx/models/ai/conversations/insight_group_delete_params"
@@ -400,6 +404,7 @@ require_relative "telnyx/models/ai/openai/embedding_list_embedding_models_respon
 require_relative "telnyx/models/ai/openai_create_response_params"
 require_relative "telnyx/models/ai/openai_create_response_response"
 require_relative "telnyx/models/ai/openai_list_models_params"
+require_relative "telnyx/models/ai/pay_tool_params"
 require_relative "telnyx/models/ai/post_conversation_settings"
 require_relative "telnyx/models/ai/post_conversation_settings_req"
 require_relative "telnyx/models/ai/privacy_settings"
@@ -2152,6 +2157,16 @@ require_relative "telnyx/models/storage/buckets/usage_get_api_usage_params"
 require_relative "telnyx/models/storage/buckets/usage_get_api_usage_response"
 require_relative "telnyx/models/storage/buckets/usage_get_bucket_usage_params"
 require_relative "telnyx/models/storage/buckets/usage_get_bucket_usage_response"
+require_relative "telnyx/models/storage/cloudf_create_params"
+require_relative "telnyx/models/storage/cloudf_delete_params"
+require_relative "telnyx/models/storage/cloudf_list_params"
+require_relative "telnyx/models/storage/cloudf_list_response"
+require_relative "telnyx/models/storage/cloudf_retrieve_params"
+require_relative "telnyx/models/storage/cloudfs/action_rotate_meta_token_params"
+require_relative "telnyx/models/storage/cloudfs_filesystem_detail_response_wrapper"
+require_relative "telnyx/models/storage/cloudfs_filesystem_response_wrapper"
+require_relative "telnyx/models/storage/cloudfs_filesystem_status"
+require_relative "telnyx/models/storage/cloudf_update_params"
 require_relative "telnyx/models/storage/kv_create_params"
 require_relative "telnyx/models/storage/kv_delete_params"
 require_relative "telnyx/models/storage/kv_list_params"
@@ -2560,6 +2575,8 @@ require_relative "telnyx/resources/addresses"
 require_relative "telnyx/resources/addresses/actions"
 require_relative "telnyx/resources/advanced_orders"
 require_relative "telnyx/resources/ai"
+require_relative "telnyx/resources/ai/anthropic"
+require_relative "telnyx/resources/ai/anthropic/v1"
 require_relative "telnyx/resources/ai/assistants"
 require_relative "telnyx/resources/ai/assistants/canary_deploys"
 require_relative "telnyx/resources/ai/assistants/instructions"
@@ -2575,6 +2592,7 @@ require_relative "telnyx/resources/ai/audio"
 require_relative "telnyx/resources/ai/chat"
 require_relative "telnyx/resources/ai/clusters"
 require_relative "telnyx/resources/ai/conversations"
+require_relative "telnyx/resources/ai/conversations/conversation_insights"
 require_relative "telnyx/resources/ai/conversations/insight_groups"
 require_relative "telnyx/resources/ai/conversations/insight_groups/insights"
 require_relative "telnyx/resources/ai/conversations/insights"
@@ -2825,6 +2843,8 @@ require_relative "telnyx/resources/storage"
 require_relative "telnyx/resources/storage/buckets"
 require_relative "telnyx/resources/storage/buckets/ssl_certificate"
 require_relative "telnyx/resources/storage/buckets/usage"
+require_relative "telnyx/resources/storage/cloudfs"
+require_relative "telnyx/resources/storage/cloudfs/actions"
 require_relative "telnyx/resources/storage/kvs"
 require_relative "telnyx/resources/storage/kvs/keys"
 require_relative "telnyx/resources/storage/migrations"