telnyx 5.151.0 → 5.152.0

data/lib/telnyx/models/dir_update_infringement_params.rb

@@ -55,7 +55,8 @@ module Telnyx
       optional :display_name, String, nil?: true
 
       # @!attribute documents
-      #   Append-only supporting documents.
+      #   Append-only supporting documents to attach while resolving the claim (e.g.
+      #   authorization or licensing proof).
       #
       #   @return [Array<Telnyx::Models::Document>, nil]
       optional :documents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Document] }, nil?: true
@@ -67,6 +68,9 @@ module Telnyx
       optional :logo_url, String, nil?: true
 
       # @!method initialize(dir_id:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_infringement:, certify_no_shaft_content:, infringement_resolution_notes:, call_reasons: nil, display_name: nil, documents: nil, logo_url: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DirUpdateInfringementParams} for more details.
+      #
       #   @param dir_id [String]
       #
       #   @param certify_brand_is_accurate [Boolean, Telnyx::Models::DirUpdateInfringementParams::CertifyBrandIsAccurate] Must be `true`.
@@ -83,7 +87,7 @@ module Telnyx
       #
       #   @param display_name [String, nil]
       #
-      #   @param documents [Array<Telnyx::Models::Document>, nil] Append-only supporting documents.
+      #   @param documents [Array<Telnyx::Models::Document>, nil] Append-only supporting documents to attach while resolving the claim (e.g. autho
       #
       #   @param logo_url [String, nil] Publicly accessible HTTPS URL (max 128 chars) to a 256x256 BMP logo (max 1 MB).
       #

data/lib/telnyx/models/enterprises/dir_create_params.rb

@@ -27,6 +27,13 @@ module Telnyx
         #   @return [String]
         required :authorizer_name, String
 
+        # @!attribute call_reasons
+        #   1–10 reasons your business calls customers. Validate phrasing against
+        #   `POST /call_reasons/validate`.
+        #
+        #   @return [Array<String>]
+        required :call_reasons, Telnyx::Internal::Type::ArrayOf[String]
+
         # @!attribute certify_brand_is_accurate
         #   Must be `true`.
         #
@@ -54,13 +61,6 @@ module Telnyx
         #   @return [String]
         required :display_name, String
 
-        # @!attribute call_reasons
-        #   1–10 reasons your business calls customers. Validate phrasing against
-        #   `POST /call_reasons/validate`.
-        #
-        #   @return [Array<String>, nil]
-        optional :call_reasons, Telnyx::Internal::Type::ArrayOf[String]
-
         # @!attribute documents
         #   Supporting documents. Each `document_id` may appear at most once on a DIR.
         #
@@ -80,7 +80,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :reselling, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(enterprise_id:, authorizer_email:, authorizer_name:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, call_reasons: nil, documents: nil, logo_url: nil, reselling: nil, request_options: {})
+        # @!method initialize(enterprise_id:, authorizer_email:, authorizer_name:, call_reasons:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, documents: nil, logo_url: nil, reselling: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Enterprises::DirCreateParams} for more details.
         #
@@ -90,6 +90,8 @@ module Telnyx
         #
         #   @param authorizer_name [String] Name of the person at your enterprise who is authorizing this DIR registration.
         #
+        #   @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
+        #
         #   @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Must be `true`.
         #
         #   @param certify_ip_ownership [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyIPOwnership] Must be `true`. Confirms ownership of any logos/trademarks shown.
@@ -98,8 +100,6 @@ module Telnyx
         #
         #   @param display_name [String] Name shown to call recipients. No emoji; not whitespace-only.
         #
-        #   @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
-        #
         #   @param documents [Array<Telnyx::Models::Document>] Supporting documents. Each `document_id` may appear at most once on a DIR.
         #
         #   @param logo_url [String] Publicly accessible HTTPS URL (max 128 chars) to a 256x256 BMP logo (max 1 MB).

data/lib/telnyx/models/storage/kv_create_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#create
+      class KvCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute name
+        #   Namespace name. May contain lowercase letters, numbers, and hyphens only.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(name:, request_options: {})
+        #   @param name [String] Namespace name. May contain lowercase letters, numbers, and hyphens only.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kv_delete_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#delete
+      class KvDeleteParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   @param id [String]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kv_list_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#list
+      class KvListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute page_number
+        #   The page number to load.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   The size of the page. Values above 250 are treated as 250.
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(page_number: nil, page_size: nil, request_options: {})
+        #   @param page_number [Integer] The page number to load.
+        #
+        #   @param page_size [Integer] The size of the page. Values above 250 are treated as 250.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kv_namespace.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#list
+      class KvNamespace < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute created_at
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute record_type
+        #
+        #   @return [String, nil]
+        optional :record_type, String
+
+        # @!attribute status
+        #   Provisioning status. A namespace is usable once `status` is `provision_ok`. Once
+        #   deletion completes, the namespace no longer appears in the API.
+        #
+        #   @return [Symbol, Telnyx::Models::Storage::KvNamespace::Status, nil]
+        optional :status, enum: -> { Telnyx::Storage::KvNamespace::Status }
+
+        # @!attribute updated_at
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time
+
+        # @!method initialize(id: nil, created_at: nil, name: nil, record_type: nil, status: nil, updated_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Storage::KvNamespace} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param created_at [Time]
+        #
+        #   @param name [String]
+        #
+        #   @param record_type [String]
+        #
+        #   @param status [Symbol, Telnyx::Models::Storage::KvNamespace::Status] Provisioning status. A namespace is usable once `status` is `provision_ok`. Once
+        #
+        #   @param updated_at [Time]
+
+        # Provisioning status. A namespace is usable once `status` is `provision_ok`. Once
+        # deletion completes, the namespace no longer appears in the API.
+        #
+        # @see Telnyx::Models::Storage::KvNamespace#status
+        module Status
+          extend Telnyx::Internal::Type::Enum
+
+          PENDING = :pending
+          PROVISION_OK = :provision_ok
+          PROVISION_FAILED = :provision_failed
+          DELETING = :deleting
+          DELETE_FAILED = :delete_failed
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kv_namespace_response_wrapper.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#create
+      class KvNamespaceResponseWrapper < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::Storage::KvNamespace, nil]
+        optional :data, -> { Telnyx::Storage::KvNamespace }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::Storage::KvNamespace]
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kv_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Kvs#retrieve
+      class KvRetrieveParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   @param id [String]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kvs/key_delete_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      module Kvs
+        # @see Telnyx::Resources::Storage::Kvs::Keys#delete
+        class KeyDeleteParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute key
+          #
+          #   @return [String]
+          required :key, String
+
+          # @!method initialize(id:, key:, request_options: {})
+          #   @param id [String]
+          #   @param key [String]
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kvs/key_list_params.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      module Kvs
+        # @see Telnyx::Resources::Storage::Kvs::Keys#list
+        class KeyListParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute cursor
+          #   Opaque pagination cursor from a previous response's `meta.cursor`.
+          #
+          #   @return [String, nil]
+          optional :cursor, String
+
+          # @!attribute limit
+          #   Maximum number of keys to return. Values above 1000 are treated as 1000.
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer
+
+          # @!attribute prefix
+          #   Return only keys that start with this prefix.
+          #
+          #   @return [String, nil]
+          optional :prefix, String
+
+          # @!method initialize(id:, cursor: nil, limit: nil, prefix: nil, request_options: {})
+          #   @param id [String]
+          #
+          #   @param cursor [String] Opaque pagination cursor from a previous response's `meta.cursor`.
+          #
+          #   @param limit [Integer] Maximum number of keys to return. Values above 1000 are treated as 1000.
+          #
+          #   @param prefix [String] Return only keys that start with this prefix.
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kvs/key_list_response.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      module Kvs
+        # @see Telnyx::Resources::Storage::Kvs::Keys#list
+        class KeyListResponse < Telnyx::Internal::Type::BaseModel
+          # @!attribute data
+          #
+          #   @return [Array<Telnyx::Models::Storage::Kvs::KeyListResponse::Data>, nil]
+          optional :data,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Storage::Kvs::KeyListResponse::Data] }
+
+          # @!attribute meta
+          #
+          #   @return [Telnyx::Models::Storage::Kvs::KeyListResponse::Meta, nil]
+          optional :meta, -> { Telnyx::Models::Storage::Kvs::KeyListResponse::Meta }
+
+          # @!attribute record_type
+          #
+          #   @return [String, nil]
+          optional :record_type, String
+
+          # @!method initialize(data: nil, meta: nil, record_type: nil)
+          #   @param data [Array<Telnyx::Models::Storage::Kvs::KeyListResponse::Data>]
+          #   @param meta [Telnyx::Models::Storage::Kvs::KeyListResponse::Meta]
+          #   @param record_type [String]
+
+          class Data < Telnyx::Internal::Type::BaseModel
+            # @!attribute key
+            #
+            #   @return [String, nil]
+            optional :key, String
+
+            # @!attribute size_bytes
+            #   Size of the stored value in bytes.
+            #
+            #   @return [Integer, nil]
+            optional :size_bytes, Integer
+
+            # @!attribute updated_at
+            #
+            #   @return [Time, nil]
+            optional :updated_at, Time
+
+            # @!method initialize(key: nil, size_bytes: nil, updated_at: nil)
+            #   @param key [String]
+            #
+            #   @param size_bytes [Integer] Size of the stored value in bytes.
+            #
+            #   @param updated_at [Time]
+          end
+
+          # @see Telnyx::Models::Storage::Kvs::KeyListResponse#meta
+          class Meta < Telnyx::Internal::Type::BaseModel
+            # @!attribute cursor
+            #   Opaque cursor for the next page; pass it back as the `cursor` query parameter.
+            #   Omitted when there are no further results.
+            #
+            #   @return [String, nil]
+            optional :cursor, String
+
+            # @!attribute has_more
+            #   Whether more results are available on a following page.
+            #
+            #   @return [Boolean, nil]
+            optional :has_more, Telnyx::Internal::Type::Boolean
+
+            # @!method initialize(cursor: nil, has_more: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::Storage::Kvs::KeyListResponse::Meta} for more details.
+            #
+            #   @param cursor [String] Opaque cursor for the next page; pass it back as the `cursor` query parameter. O
+            #
+            #   @param has_more [Boolean] Whether more results are available on a following page.
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kvs/key_retrieve_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      module Kvs
+        # @see Telnyx::Resources::Storage::Kvs::Keys#retrieve
+        class KeyRetrieveParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute key
+          #
+          #   @return [String]
+          required :key, String
+
+          # @!method initialize(id:, key:, request_options: {})
+          #   @param id [String]
+          #   @param key [String]
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/kvs/key_update_params.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      module Kvs
+        # @see Telnyx::Resources::Storage::Kvs::Keys#update
+        class KeyUpdateParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute key
+          #
+          #   @return [String]
+          required :key, String
+
+          # @!attribute body
+          #   Raw value bytes, stored verbatim.
+          #
+          #   @return [Pathname, StringIO, IO, String, Telnyx::FilePart]
+          required :body, Telnyx::Internal::Type::FileInput
+
+          # @!attribute ttl_secs
+          #   Time-to-live in seconds. When set, the key expires and is deleted after this
+          #   duration. Requires a namespace provisioned with TTL support; namespaces without
+          #   it return a `409`.
+          #
+          #   @return [Integer, nil]
+          optional :ttl_secs, Integer
+
+          # @!method initialize(id:, key:, body:, ttl_secs: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Storage::Kvs::KeyUpdateParams} for more details.
+          #
+          #   @param id [String]
+          #
+          #   @param key [String]
+          #
+          #   @param body [Pathname, StringIO, IO, String, Telnyx::FilePart] Raw value bytes, stored verbatim.
+          #
+          #   @param ttl_secs [Integer] Time-to-live in seconds. When set, the key expires and is deleted after this dur
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Whatsapp
+      # @see Telnyx::Resources::Whatsapp::PhoneNumbers#retrieve_conversation_window
+      class PhoneNumberRetrieveConversationWindowParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute phone_number
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!attribute destination_number
+        #   Destination phone number in E.164 format
+        #
+        #   @return [String]
+        required :destination_number, String
+
+        # @!method initialize(phone_number:, destination_number:, request_options: {})
+        #   @param phone_number [String]
+        #
+        #   @param destination_number [String] Destination phone number in E.164 format
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_response.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Whatsapp
+      # @see Telnyx::Resources::Whatsapp::PhoneNumbers#retrieve_conversation_window
+      class PhoneNumberRetrieveConversationWindowResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data, nil]
+        optional :data, -> { Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data]
+
+        # @see Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute last_user_message_at
+          #   Timestamp of the last inbound message that opened the window
+          #
+          #   @return [Time, nil]
+          optional :last_user_message_at, Time
+
+          # @!attribute window_active
+          #   Whether the 24-hour conversation window is currently open
+          #
+          #   @return [Boolean, nil]
+          optional :window_active, Telnyx::Internal::Type::Boolean
+
+          # @!attribute window_expires_at
+          #   When the window closes. Null if no active window.
+          #
+          #   @return [Time, nil]
+          optional :window_expires_at, Time
+
+          # @!attribute window_type
+          #   Window type. Currently always 24h when present.
+          #
+          #   @return [String, nil]
+          optional :window_type, String
+
+          # @!method initialize(last_user_message_at: nil, window_active: nil, window_expires_at: nil, window_type: nil)
+          #   @param last_user_message_at [Time] Timestamp of the last inbound message that opened the window
+          #
+          #   @param window_active [Boolean] Whether the 24-hour conversation window is currently open
+          #
+          #   @param window_expires_at [Time] When the window closes. Null if no active window.
+          #
+          #   @param window_type [String] Window type. Currently always 24h when present.
+        end
+      end
+    end
+  end
+end