telnyx 5.171.0 → 5.174.0

data/lib/telnyx/models/session.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class Session < Telnyx::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute closed_at
+      #
+      #   @return [Time, nil]
+      required :closed_at, Time, nil?: true
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute expires_at
+      #
+      #   @return [Time, nil]
+      required :expires_at, Time, nil?: true
+
+      # @!attribute failure_reason
+      #
+      #   @return [String, nil]
+      required :failure_reason, String, nil?: true
+
+      # @!attribute last_activity_at
+      #
+      #   @return [Time, nil]
+      required :last_activity_at, Time, nil?: true
+
+      # @!attribute limits
+      #
+      #   @return [Telnyx::Models::Session::Limits]
+      required :limits, -> { Telnyx::Session::Limits }
+
+      # @!attribute metadata
+      #
+      #   @return [Object]
+      required :metadata, Telnyx::Internal::Type::Unknown
+
+      # @!attribute policy
+      #
+      #   @return [Telnyx::Models::Session::Policy]
+      required :policy, -> { Telnyx::Session::Policy }
+
+      # @!attribute ready_at
+      #
+      #   @return [Time, nil]
+      required :ready_at, Time, nil?: true
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Telnyx::Models::Session::Status]
+      required :status, enum: -> { Telnyx::Session::Status }
+
+      # @!method initialize(id:, closed_at:, created_at:, expires_at:, failure_reason:, last_activity_at:, limits:, metadata:, policy:, ready_at:, status:)
+      #   @param id [String]
+      #   @param closed_at [Time, nil]
+      #   @param created_at [Time]
+      #   @param expires_at [Time, nil]
+      #   @param failure_reason [String, nil]
+      #   @param last_activity_at [Time, nil]
+      #   @param limits [Telnyx::Models::Session::Limits]
+      #   @param metadata [Object]
+      #   @param policy [Telnyx::Models::Session::Policy]
+      #   @param ready_at [Time, nil]
+      #   @param status [Symbol, Telnyx::Models::Session::Status]
+
+      # @see Telnyx::Models::Session#limits
+      class Limits < Telnyx::Internal::Type::BaseModel
+        # @!attribute idle_timeout_s
+        #
+        #   @return [Integer]
+        required :idle_timeout_s, Integer
+
+        # @!attribute lifetime_s
+        #
+        #   @return [Integer]
+        required :lifetime_s, Integer
+
+        # @!method initialize(idle_timeout_s:, lifetime_s:)
+        #   @param idle_timeout_s [Integer]
+        #   @param lifetime_s [Integer]
+      end
+
+      # @see Telnyx::Models::Session#policy
+      class Policy < Telnyx::Internal::Type::BaseModel
+        # @!attribute allowed_domains
+        #
+        #   @return [Array<String>]
+        required :allowed_domains, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(allowed_domains:)
+        #   @param allowed_domains [Array<String>]
+      end
+
+      # @see Telnyx::Models::Session#status
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        PROVISIONING = :provisioning
+        READY = :ready
+        CLOSING = :closing
+        CLOSED = :closed
+        FAILED = :failed
+        EXPIRED = :expired
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/session_status_changed_webhook_event.rb

@@ -65,16 +65,12 @@ module Telnyx
         required :status, String
 
         # @!attribute status_detail
-        #   Additional detail about the status (for example `timeout_exceeded_everyone_left`
-        #   or `cancelled`), or null.
+        #   Additional detail about the status (for example `cancelled`), or null.
         #
         #   @return [String, nil]
         required :status_detail, String, nil?: true
 
         # @!method initialize(recording:, session_id:, status:, status_detail:)
-        #   Some parameter documentations has been truncated, see
-        #   {Telnyx::Models::SessionStatusChangedWebhookEvent::Data} for more details.
-        #
         #   Status transition details.
         #
         #   @param recording [Boolean] Whether the session is recording at this lifecycle edge.
@@ -83,7 +79,7 @@ module Telnyx
         #
         #   @param status [String] The new session status.
         #
-        #   @param status_detail [String, nil] Additional detail about the status (for example `timeout_exceeded_everyone_left`
+        #   @param status_detail [String, nil] Additional detail about the status (for example `cancelled`), or null.
       end
 
       # Event type.

data/lib/telnyx/models/speech_to_text_retrieve_transcription_params.rb

@@ -23,9 +23,10 @@ module Telnyx
       # @!attribute endpointing
       #   Silence duration (in milliseconds) that triggers end-of-speech detection. When
       #   set, the engine uses this value to determine when a speaker has stopped talking.
-      #   Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`, and `Soniox`. `Soniox`
-      #   accepts values between 500 and 3000. Other engines may not support this
-      #   parameter.
+      #   Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`
+      #   (`speechmatics/standard` only; `speechmatics/linden-1` uses fixed service-side
+      #   voice activity detection and ignores it), and `Soniox`. `Soniox` accepts values
+      #   between 500 and 3000. Other engines may not support this parameter.
       #
       #   @return [Integer, nil]
       optional :endpointing, Integer
@@ -53,7 +54,12 @@ module Telnyx
       # @!attribute language
       #   The language spoken in the audio stream. For `cohere/ar-stt`, this must be `ar`
       #   or `en` — unlike other engines, Cohere does not auto-detect the language, and
-      #   rejects unsupported values including `auto`; omitting it defaults to `ar`.
+      #   rejects unsupported values including `auto`; omitting it defaults to `ar`. For
+      #   `speechmatics/linden-1`, omitting it defaults to `en`; `auto`, `auto_beta`,
+      #   `multi`, or a language outside its supported list is rejected when the
+      #   connection is established. `speechmatics/linden-1` also accepts `en-US`,
+      #   `en-GB`, `en-AU`, `cmn-Hans`, and `cmn-Hant`, which select the spelling or
+      #   script variant (`en` alone uses the default spelling).
       #
       #   @return [String, nil]
       optional :language, String
@@ -75,6 +81,7 @@ module Telnyx
       #   Audio sample rate in Hz. Required when `input_format` is a raw encoding
       #   (`linear16`, `linear32`) — those formats carry no header metadata. Ignored for
       #   container formats (`mp3`, `wav`), which self-describe their rate.
+      #   `speechmatics/linden-1` accepts only `16000`.
       #
       #   @return [Integer, nil]
       optional :sample_rate, Integer
@@ -157,6 +164,7 @@ module Telnyx
         OPENAI_WHISPER_LARGE_V3_TURBO = :"openai/whisper-large-v3-turbo"
         XAI_GROK_STT = :"xai/grok-stt"
         SPEECHMATICS_STANDARD = :"speechmatics/standard"
+        SPEECHMATICS_LINDEN_1 = :"speechmatics/linden-1"
         SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
         NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
         OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"

data/lib/telnyx/models/spend_limit.rb

@@ -6,12 +6,13 @@ module Telnyx
       # @!attribute block
       #   The active block of the period. `null` when the period is not blocked.
       #
-      #   @return [Telnyx::Models::SpendLimit::Block, nil]
-      required :block, -> { Telnyx::SpendLimit::Block }, nil?: true
+      #   @return [Telnyx::Models::SpendLimitBlock, nil]
+      required :block, -> { Telnyx::SpendLimitBlock }, nil?: true
 
       # @!attribute blocked
-      #   The product is blocked for this period. Always `false` in write responses; list
-      #   the limits to read the block state.
+      #   The product is blocked for the whole account in this period (total limit). An
+      #   API key's own block appears only in `credential_limits`. Always `false` in write
+      #   responses; list the limits to read the block state.
       #
       #   @return [Boolean]
       required :blocked, Telnyx::Internal::Type::Boolean
@@ -78,6 +79,21 @@ module Telnyx
       #   @return [String, nil]
       required :spend_usd, String, nil?: true
 
+      # @!attribute credential_id
+      #   In write responses, the API key the write was about; `null` for the total limit.
+      #   Always `null` in list entries, which describe the total limit.
+      #
+      #   @return [String, nil]
+      optional :credential_id, String, nil?: true
+
+      # @!attribute credential_limits
+      #   List responses only. One item per API key limit of the product and period,
+      #   sorted by `credential_id`, plus every API key that is still blocked. `[]` when
+      #   there are none.
+      #
+      #   @return [Array<Telnyx::Models::SpendLimit::CredentialLimit>, nil]
+      optional :credential_limits, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::SpendLimit::CredentialLimit] }
+
       # @!attribute evaluation
       #   What a create, update or delete did to the period at once. Only present in write
       #   responses.
@@ -85,15 +101,17 @@ module Telnyx
       #   @return [Telnyx::Models::SpendLimit::Evaluation, nil]
       optional :evaluation, -> { Telnyx::SpendLimit::Evaluation }
 
-      # @!method initialize(block:, blocked:, effective_limit_usd:, limit:, period:, period_end:, period_start:, product:, product_name:, record_type:, spend_error:, spend_usd:, evaluation: nil)
+      # @!method initialize(block:, blocked:, effective_limit_usd:, limit:, period:, period_end:, period_start:, product:, product_name:, record_type:, spend_error:, spend_usd:, credential_id: nil, credential_limits: nil, evaluation: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::SpendLimit} for more details.
       #
-      #   The spend limit, spend and block state of one product and period.
+      #   The spend limit, spend and block state of one product and period. The top-level
+      #   fields describe the total limit of the account; API key limits are nested in
+      #   `credential_limits`.
       #
-      #   @param block [Telnyx::Models::SpendLimit::Block, nil] The active block of the period. `null` when the period is not blocked.
+      #   @param block [Telnyx::Models::SpendLimitBlock, nil] The active block of the period. `null` when the period is not blocked.
       #
-      #   @param blocked [Boolean] The product is blocked for this period. Always `false` in write responses; list
+      #   @param blocked [Boolean] The product is blocked for the whole account in this period (total limit). An AP
       #
       #   @param effective_limit_usd [String, nil] The limit in USD that is enforced, as a decimal string. `null` means unlimited.
       #
@@ -115,50 +133,12 @@ module Telnyx
       #
       #   @param spend_usd [String, nil] Spend in USD so far in the period, as a decimal string. It can lag actual usage
       #
+      #   @param credential_id [String, nil] In write responses, the API key the write was about; `null` for the total limit.
+      #
+      #   @param credential_limits [Array<Telnyx::Models::SpendLimit::CredentialLimit>] List responses only. One item per API key limit of the product and period, sorte
+      #
       #   @param evaluation [Telnyx::Models::SpendLimit::Evaluation] What a create, update or delete did to the period at once. Only present in write
 
-      # @see Telnyx::Models::SpendLimit#block
-      class Block < Telnyx::Internal::Type::BaseModel
-        # @!attribute blocked_until
-        #   Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
-        #   latest.
-        #
-        #   @return [Date]
-        required :blocked_until, Date
-
-        # @!attribute detected_at
-        #   When the block started.
-        #
-        #   @return [Time]
-        required :detected_at, Time
-
-        # @!attribute limit_usd
-        #   The limit in USD that the spend went above, as a decimal string.
-        #
-        #   @return [String]
-        required :limit_usd, String
-
-        # @!attribute spend_usd
-        #   Spend in USD when the block started, as a decimal string.
-        #
-        #   @return [String]
-        required :spend_usd, String
-
-        # @!method initialize(blocked_until:, detected_at:, limit_usd:, spend_usd:)
-        #   Some parameter documentations has been truncated, see
-        #   {Telnyx::Models::SpendLimit::Block} for more details.
-        #
-        #   The active block of the period. `null` when the period is not blocked.
-        #
-        #   @param blocked_until [Date] Exclusive end of the block: it is lifted at 00:00 UTC on this date at the latest
-        #
-        #   @param detected_at [Time] When the block started.
-        #
-        #   @param limit_usd [String] The limit in USD that the spend went above, as a decimal string.
-        #
-        #   @param spend_usd [String] Spend in USD when the block started, as a decimal string.
-      end
-
       # @see Telnyx::Models::SpendLimit#limit
       class Limit < Telnyx::Internal::Type::BaseModel
         # @!attribute amount
@@ -216,6 +196,124 @@ module Telnyx
         end
       end
 
+      class CredentialLimit < Telnyx::Internal::Type::BaseModel
+        # @!attribute block
+        #   The active block of the period. `null` when the period is not blocked.
+        #
+        #   @return [Telnyx::Models::SpendLimitBlock, nil]
+        required :block, -> { Telnyx::SpendLimitBlock }, nil?: true
+
+        # @!attribute blocked
+        #   This API key is blocked for the period.
+        #
+        #   @return [Boolean]
+        required :blocked, Telnyx::Internal::Type::Boolean
+
+        # @!attribute credential_id
+        #   Identifier of the API key as recorded on usage. Never the key's secret.
+        #
+        #   @return [String]
+        required :credential_id, String
+
+        # @!attribute limit
+        #   The limit of one API key. It always has an amount. `null` for an API key that is
+        #   still blocked after its limit was removed.
+        #
+        #   @return [Telnyx::Models::SpendLimit::CredentialLimit::Limit, nil]
+        required :limit, -> { Telnyx::SpendLimit::CredentialLimit::Limit }, nil?: true
+
+        # @!attribute spend_error
+        #   Set when `spend_usd` is `null`.
+        #
+        #   @return [String, nil]
+        required :spend_error, String, nil?: true
+
+        # @!attribute spend_usd
+        #   Spend in USD in the period made with exactly this API key, as a decimal string.
+        #   Usage without an API key identifier, or with another one, counts only toward the
+        #   total. `null` when it could not be read.
+        #
+        #   @return [String, nil]
+        required :spend_usd, String, nil?: true
+
+        # @!attribute exceeds_total
+        #   The API key's limit is above the period's total limit. Only a change by Telnyx
+        #   support can cause it; the total limit still applies to the whole account. Lower
+        #   the API key limit or raise the total.
+        #
+        #   @return [Boolean, nil]
+        optional :exceeds_total, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(block:, blocked:, credential_id:, limit:, spend_error:, spend_usd:, exceeds_total: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::SpendLimit::CredentialLimit} for more details.
+        #
+        #   The limit, spend and block state of one API key in the product and period.
+        #
+        #   @param block [Telnyx::Models::SpendLimitBlock, nil] The active block of the period. `null` when the period is not blocked.
+        #
+        #   @param blocked [Boolean] This API key is blocked for the period.
+        #
+        #   @param credential_id [String] Identifier of the API key as recorded on usage. Never the key's secret.
+        #
+        #   @param limit [Telnyx::Models::SpendLimit::CredentialLimit::Limit, nil] The limit of one API key. It always has an amount. `null` for an API key that is
+        #
+        #   @param spend_error [String, nil] Set when `spend_usd` is `null`.
+        #
+        #   @param spend_usd [String, nil] Spend in USD in the period made with exactly this API key, as a decimal string.
+        #
+        #   @param exceeds_total [Boolean] The API key's limit is above the period's total limit. Only a change by Telnyx s
+
+        # @see Telnyx::Models::SpendLimit::CredentialLimit#limit
+        class Limit < Telnyx::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Limit in USD, as a decimal string.
+          #
+          #   @return [String]
+          required :amount, String
+
+          # @!attribute origin
+          #   `self_service` when a user of the account set it, `operator` when Telnyx support
+          #   did.
+          #
+          #   @return [Symbol, Telnyx::Models::SpendLimit::CredentialLimit::Limit::Origin]
+          required :origin, enum: -> { Telnyx::SpendLimit::CredentialLimit::Limit::Origin }
+
+          # @!attribute updated_at
+          #   When the limit was last set or changed.
+          #
+          #   @return [Time]
+          required :updated_at, Time
+
+          # @!method initialize(amount:, origin:, updated_at:)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::SpendLimit::CredentialLimit::Limit} for more details.
+          #
+          #   The limit of one API key. It always has an amount. `null` for an API key that is
+          #   still blocked after its limit was removed.
+          #
+          #   @param amount [String] Limit in USD, as a decimal string.
+          #
+          #   @param origin [Symbol, Telnyx::Models::SpendLimit::CredentialLimit::Limit::Origin] `self_service` when a user of the account set it, `operator` when Telnyx support
+          #
+          #   @param updated_at [Time] When the limit was last set or changed.
+
+          # `self_service` when a user of the account set it, `operator` when Telnyx support
+          # did.
+          #
+          # @see Telnyx::Models::SpendLimit::CredentialLimit::Limit#origin
+          module Origin
+            extend Telnyx::Internal::Type::Enum
+
+            SELF_SERVICE = :self_service
+            OPERATOR = :operator
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
       # @see Telnyx::Models::SpendLimit#evaluation
       class Evaluation < Telnyx::Internal::Type::BaseModel
         # @!attribute blocked_now
@@ -246,7 +344,7 @@ module Telnyx
 
         # @!attribute still_blocked_other_period
         #   The other period has an active block, so the product stays blocked whatever this
-        #   period's result.
+        #   period's result. For an API key write, the API key's limit in the other period.
         #
         #   @return [Boolean]
         required :still_blocked_other_period, Telnyx::Internal::Type::Boolean
@@ -257,13 +355,20 @@ module Telnyx
         #   @return [Boolean]
         required :still_over_limit, Telnyx::Internal::Type::Boolean
 
+        # @!attribute account_blocked
+        #   API key writes only: the account itself remains blocked for the product under a
+        #   total limit. Absent for total limit writes.
+        #
+        #   @return [Boolean, nil]
+        optional :account_blocked, Telnyx::Internal::Type::Boolean
+
         # @!attribute note
         #   Additional information about the result, when there is any.
         #
         #   @return [String, nil]
         optional :note, String
 
-        # @!method initialize(blocked_now:, evaluation_deferred:, released:, spend_usd:, still_blocked_other_period:, still_over_limit:, note: nil)
+        # @!method initialize(blocked_now:, evaluation_deferred:, released:, spend_usd:, still_blocked_other_period:, still_over_limit:, account_blocked: nil, note: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::SpendLimit::Evaluation} for more details.
         #
@@ -282,6 +387,8 @@ module Telnyx
         #
         #   @param still_over_limit [Boolean] A block of this period remains because the spend is still above the new limit.
         #
+        #   @param account_blocked [Boolean] API key writes only: the account itself remains blocked for the product under a
+        #
         #   @param note [String] Additional information about the result, when there is any.
       end
     end

data/lib/telnyx/models/spend_limit_block.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class SpendLimitBlock < Telnyx::Internal::Type::BaseModel
+      # @!attribute blocked_until
+      #   Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
+      #   latest.
+      #
+      #   @return [Date]
+      required :blocked_until, Date
+
+      # @!attribute detected_at
+      #   When the block started.
+      #
+      #   @return [Time]
+      required :detected_at, Time
+
+      # @!attribute limit_usd
+      #   The limit in USD that the spend went above, as a decimal string.
+      #
+      #   @return [String]
+      required :limit_usd, String
+
+      # @!attribute spend_usd
+      #   Spend in USD when the block started, as a decimal string.
+      #
+      #   @return [String]
+      required :spend_usd, String
+
+      # @!method initialize(blocked_until:, detected_at:, limit_usd:, spend_usd:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::SpendLimitBlock} for more details.
+      #
+      #   The active block of the period. `null` when the period is not blocked.
+      #
+      #   @param blocked_until [Date] Exclusive end of the block: it is lifted at 00:00 UTC on this date at the latest
+      #
+      #   @param detected_at [Time] When the block started.
+      #
+      #   @param limit_usd [String] The limit in USD that the spend went above, as a decimal string.
+      #
+      #   @param spend_usd [String] Spend in USD when the block started, as a decimal string.
+    end
+  end
+end

data/lib/telnyx/models/spend_limit_create_params.rb

@@ -25,7 +25,7 @@ module Telnyx
         # A limit in USD.
         variant -> { Telnyx::SpendLimitCreateParams::Body::CreateSpendLimitWithAmount }
 
-        # Explicitly no cap.
+        # Explicitly no cap. Not available for API key limits.
         variant -> { Telnyx::SpendLimitCreateParams::Body::CreateSpendLimitUnlimited }
 
         class CreateSpendLimitWithAmount < Telnyx::Internal::Type::BaseModel
@@ -41,6 +41,15 @@ module Telnyx
           #   @return [String]
           required :product, String
 
+          # @!attribute credential_id
+          #   Optional. Identifier of one API key as recorded on usage, never the key's
+          #   secret: the limit then applies to that key only. Absent or `null` sets the total
+          #   limit. A blank value, or one with control characters, is refused; it never means
+          #   the total limit. An API key limit always has an `amount`.
+          #
+          #   @return [String, nil]
+          optional :credential_id, String, nil?: true
+
           # @!attribute period
           #   `daily` is the current UTC day; `monthly` is the current UTC calendar month.
           #
@@ -60,13 +69,19 @@ module Telnyx
           optional :unlimited,
                    enum: -> { Telnyx::SpendLimitCreateParams::Body::CreateSpendLimitWithAmount::Unlimited }
 
-          # @!method initialize(amount:, product:, period: nil, reason: nil, unlimited: nil)
+          # @!method initialize(amount:, product:, credential_id: nil, period: nil, reason: nil, unlimited: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::SpendLimitCreateParams::Body::CreateSpendLimitWithAmount} for
+          #   more details.
+          #
           #   A limit in USD.
           #
           #   @param amount [Float] Limit in USD. `0` blocks at the first cent of spend.
           #
           #   @param product [String] Product to limit, as returned in `product` by the list operation.
           #
+          #   @param credential_id [String, nil] Optional. Identifier of one API key as recorded on usage, never the key's secret
+          #
           #   @param period [Symbol, Telnyx::Models::SpendLimitPeriod] `daily` is the current UTC day; `monthly` is the current UTC calendar month.
           #
           #   @param reason [String] Why the limit is set or changed, kept for audit.
@@ -113,7 +128,7 @@ module Telnyx
           optional :reason, String
 
           # @!method initialize(product:, unlimited:, period: nil, reason: nil)
-          #   Explicitly no cap.
+          #   Explicitly no cap. Not available for API key limits.
           #
           #   @param product [String] Product to limit, as returned in `product` by the list operation.
           #

data/lib/telnyx/models/spend_limit_delete_params.rb

@@ -12,6 +12,14 @@ module Telnyx
       #   @return [String]
       required :product, String
 
+      # @!attribute credential_id
+      #   Identifier of one API key as recorded on usage, never the key's secret,
+      #   percent-encoded: the request is then about that key's limit. Absent means the
+      #   total limit; present but blank is refused.
+      #
+      #   @return [String, nil]
+      optional :credential_id, String
+
       # @!attribute period
       #   Limit period. Defaults to `daily`; send it explicitly.
       #
@@ -24,9 +32,14 @@ module Telnyx
       #   @return [String, nil]
       optional :reason, String
 
-      # @!method initialize(product:, period: nil, reason: nil, request_options: {})
+      # @!method initialize(product:, credential_id: nil, period: nil, reason: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::SpendLimitDeleteParams} for more details.
+      #
       #   @param product [String]
       #
+      #   @param credential_id [String] Identifier of one API key as recorded on usage, never the key's secret, percent-
+      #
       #   @param period [Symbol, Telnyx::Models::SpendLimitPeriod] Limit period. Defaults to `daily`; send it explicitly.
       #
       #   @param reason [String] Why the limit is removed, kept for audit. At most 500 characters.

data/lib/telnyx/models/spend_limit_response.rb

@@ -5,13 +5,18 @@ module Telnyx
     # @see Telnyx::Resources::SpendLimits#create
     class SpendLimitResponse < Telnyx::Internal::Type::BaseModel
       # @!attribute data
-      #   The spend limit, spend and block state of one product and period.
+      #   The spend limit, spend and block state of one product and period. The top-level
+      #   fields describe the total limit of the account; API key limits are nested in
+      #   `credential_limits`.
       #
       #   @return [Telnyx::Models::SpendLimit]
       required :data, -> { Telnyx::SpendLimit }
 
       # @!method initialize(data:)
-      #   @param data [Telnyx::Models::SpendLimit] The spend limit, spend and block state of one product and period.
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::SpendLimitResponse} for more details.
+      #
+      #   @param data [Telnyx::Models::SpendLimit] The spend limit, spend and block state of one product and period. The top-level
     end
   end
 end

data/lib/telnyx/models/spend_limit_update_params.rb

@@ -18,17 +18,30 @@ module Telnyx
       #   @return [Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitWithAmount, Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitUnlimited]
       required :body, union: -> { Telnyx::SpendLimitUpdateParams::Body }
 
+      # @!attribute credential_id
+      #   Identifier of one API key as recorded on usage, never the key's secret,
+      #   percent-encoded: the request is then about that key's limit. Absent means the
+      #   total limit; present but blank is refused.
+      #
+      #   @return [String, nil]
+      optional :credential_id, String
+
       # @!attribute period
       #   Limit period. Defaults to `daily`; send it explicitly.
       #
       #   @return [Symbol, Telnyx::Models::SpendLimitPeriod, nil]
       optional :period, enum: -> { Telnyx::SpendLimitPeriod }
 
-      # @!method initialize(product:, body:, period: nil, request_options: {})
+      # @!method initialize(product:, body:, credential_id: nil, period: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::SpendLimitUpdateParams} for more details.
+      #
       #   @param product [String]
       #
       #   @param body [Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitWithAmount, Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitUnlimited] Send exactly one of `amount` and `unlimited: true`.
       #
+      #   @param credential_id [String] Identifier of one API key as recorded on usage, never the key's secret, percent-
+      #
       #   @param period [Symbol, Telnyx::Models::SpendLimitPeriod] Limit period. Defaults to `daily`; send it explicitly.
       #
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]