telnyx 5.151.0 → 5.153.0

data/lib/telnyx/models/dir/reference_update_params.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Dir
+      # @see Telnyx::Resources::Dir::References#update
+      class ReferenceUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute dir_id
+        #
+        #   @return [String]
+        required :dir_id, String
+
+        # @!attribute ref_type
+        #
+        #   @return [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType]
+        required :ref_type, enum: -> { Telnyx::Dir::ReferenceUpdateParams::RefType }
+
+        # @!attribute slot
+        #
+        #   @return [Integer]
+        required :slot, Integer
+
+        # @!attribute email
+        #   Reference contact email address.
+        #
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute full_name
+        #   Full name of the reference contact.
+        #
+        #   @return [String, nil]
+        optional :full_name, String
+
+        # @!attribute job_title
+        #   Job title of the reference contact.
+        #
+        #   @return [String, nil]
+        optional :job_title, String, nil?: true
+
+        # @!attribute organization
+        #   Organization the reference contact belongs to.
+        #
+        #   @return [String, nil]
+        optional :organization, String, nil?: true
+
+        # @!attribute phone_e164
+        #   Reference phone number in E.164 format.
+        #
+        #   @return [String, nil]
+        optional :phone_e164, String
+
+        # @!attribute relationship_to_registrant
+        #   How the reference contact is related to the registering business.
+        #
+        #   @return [String, nil]
+        optional :relationship_to_registrant, String, nil?: true
+
+        # @!attribute timezone
+        #   IANA timezone id for the reference.
+        #
+        #   @return [String, nil]
+        optional :timezone, String
+
+        # @!method initialize(dir_id:, ref_type:, slot:, email: nil, full_name: nil, job_title: nil, organization: nil, phone_e164: nil, relationship_to_registrant: nil, timezone: nil, request_options: {})
+        #   @param dir_id [String]
+        #
+        #   @param ref_type [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType]
+        #
+        #   @param slot [Integer]
+        #
+        #   @param email [String] Reference contact email address.
+        #
+        #   @param full_name [String] Full name of the reference contact.
+        #
+        #   @param job_title [String, nil] Job title of the reference contact.
+        #
+        #   @param organization [String, nil] Organization the reference contact belongs to.
+        #
+        #   @param phone_e164 [String] Reference phone number in E.164 format.
+        #
+        #   @param relationship_to_registrant [String, nil] How the reference contact is related to the registering business.
+        #
+        #   @param timezone [String] IANA timezone id for the reference.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        module RefType
+          extend Telnyx::Internal::Type::Enum
+
+          BUSINESS = :business
+          FINANCIAL = :financial
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/dir/reference_update_response.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Dir
+      # @see Telnyx::Resources::Dir::References#update
+      class ReferenceUpdateResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   A reference (business or financial) on a DIR, in the customer-facing shape. No
+        #   internal identifiers are exposed.
+        #
+        #   @return [Telnyx::Models::Dir::Reference]
+        required :data, -> { Telnyx::Dir::Reference }
+
+        # @!method initialize(data:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Dir::ReferenceUpdateResponse} for more details.
+        #
+        #   @param data [Telnyx::Models::Dir::Reference] A reference (business or financial) on a DIR, in the customer-facing shape. No i
+      end
+    end
+  end
+end

data/lib/telnyx/models/dir/verify_email_confirm_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Dir
+      # @see Telnyx::Resources::Dir::VerifyEmail#confirm
+      class VerifyEmailConfirmParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute dir_id
+        #
+        #   @return [String]
+        required :dir_id, String
+
+        # @!attribute code
+        #   The 6-digit code sent to the authorizer email.
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!method initialize(dir_id:, code:, request_options: {})
+        #   @param dir_id [String]
+        #
+        #   @param code [String] The 6-digit code sent to the authorizer email.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/dir/verify_email_create_params.rb

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

data/lib/telnyx/models/dir/verify_email_list_params.rb

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

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,35 @@
+# 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 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
+      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