telnyx 5.170.0 → 5.171.0

data/lib/telnyx/resources/llm_token_gateway/token_groups.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class TokenGroups
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenGroupCreateParams} for more details.
+        #
+        # Create gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        #
+        # @overload create(allowed_models:, name:, idempotency_key:, blocked: nil, budget_duration: nil, cache_ttl: nil, fallbacks: nil, guardrails: nil, max_budget: nil, max_parallel_requests: nil, provider_key_ids: nil, retries: nil, rpm_limit: nil, tpm_limit: nil, request_options: {})
+        #
+        # @param allowed_models [Array<String>] Body param
+        #
+        # @param name [String] Body param
+        #
+        # @param idempotency_key [String] Header param: 24h, scoped by account+method+path. Same key/body returns same out
+        #
+        # @param blocked [Boolean] Body param
+        #
+        # @param budget_duration [Symbol, Telnyx::Models::LlmTokenGateway::BudgetDuration, nil] Body param
+        #
+        # @param cache_ttl [Integer, nil] Body param
+        #
+        # @param fallbacks [Hash{Symbol=>Array<String>}, nil] Body param: Per-group model fallbacks: primary alias -> ordered list of 1..3 oth
+        #
+        # @param guardrails [Telnyx::Models::LlmTokenGateway::TokenGroupCreateParams::Guardrails, nil] Body param: Per-group guardrail policy. Missing actions default to ignore. profi
+        #
+        # @param max_budget [Float, nil] Body param: USD, decimal precision at most 6 places; parse exactly to integer mi
+        #
+        # @param max_parallel_requests [Integer, nil] Body param: Optional maximum concurrent reserved/dispatched cache misses across
+        #
+        # @param provider_key_ids [Array<String>] Body param
+        #
+        # @param retries [Telnyx::Models::LlmTokenGateway::TokenGroupCreateParams::Retries, nil] Body param: Per-group same-route retries. max_attempts counts the first try of e
+        #
+        # @param rpm_limit [Integer, nil] Body param
+        #
+        # @param tpm_limit [Integer, nil] Body param
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenGroupResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenGroupCreateParams
+        def create(params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenGroupCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: "llm_token_gateway/token_groups",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::LlmTokenGateway::TokenGroupResponse,
+            options: options
+          )
+        end
+
+        # Get gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String]
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenGroupResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenGroupRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["llm_token_gateway/token_groups/%1$s", id],
+            model: Telnyx::LlmTokenGateway::TokenGroupResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenGroupUpdateParams} for more details.
+        #
+        # Update gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. Omitted fields are preserved.
+        # Null clears the optional concurrency, fallback and retry settings. A stale
+        # If-Match returns 412; read the resource again before updating.
+        #
+        # @overload update(id, idempotency_key:, if_match:, allowed_models: nil, blocked: nil, budget_duration: nil, cache_ttl: nil, fallbacks: nil, guardrails: nil, max_budget: nil, max_parallel_requests: nil, name: nil, provider_key_ids: nil, retries: nil, rpm_limit: nil, tpm_limit: nil, request_options: {})
+        #
+        # @param id [String] Path param
+        #
+        # @param idempotency_key [String] Header param: 24h, scoped by account+method+path. Same key/body returns same out
+        #
+        # @param if_match [String] Header param: Exact quoted resource-version ETag; an exact intermediary-weakened
+        #
+        # @param allowed_models [Array<String>] Body param
+        #
+        # @param blocked [Boolean] Body param
+        #
+        # @param budget_duration [Symbol, Telnyx::Models::LlmTokenGateway::BudgetDuration, nil] Body param
+        #
+        # @param cache_ttl [Integer, nil] Body param
+        #
+        # @param fallbacks [Hash{Symbol=>Array<String>}, nil] Body param: Per-group model fallbacks: primary alias -> ordered list of 1..3 oth
+        #
+        # @param guardrails [Telnyx::Models::LlmTokenGateway::TokenGroupUpdateParams::Guardrails, nil] Body param: Per-group guardrail policy. Missing actions default to ignore. profi
+        #
+        # @param max_budget [Float, nil] Body param: USD, decimal precision at most 6 places; parse exactly to integer mi
+        #
+        # @param max_parallel_requests [Integer, nil] Body param: Optional maximum concurrent reserved/dispatched cache misses across
+        #
+        # @param name [String] Body param
+        #
+        # @param provider_key_ids [Array<String>] Body param
+        #
+        # @param retries [Telnyx::Models::LlmTokenGateway::TokenGroupUpdateParams::Retries, nil] Body param: Per-group same-route retries. max_attempts counts the first try of e
+        #
+        # @param rpm_limit [Integer, nil] Body param
+        #
+        # @param tpm_limit [Integer, nil] Body param
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenGroupResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenGroupUpdateParams
+        def update(id, params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenGroupUpdateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key", if_match: "if-match"}
+          @client.request(
+            method: :patch,
+            path: ["llm_token_gateway/token_groups/%1$s", id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::LlmTokenGateway::TokenGroupResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenGroupListParams} for more details.
+        #
+        # List gateway token groups within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        #
+        # @overload list(page_number: nil, page_size: nil, page_snapshot: nil, request_options: {})
+        #
+        # @param page_number [Integer]
+        #
+        # @param page_size [Integer]
+        #
+        # @param page_snapshot [String] Required after page 1; account/filter-bound 15-minute stable snapshot; expired/m
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::LlmTokenGateway::TokenGroup>]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenGroupListParams
+        def list(params = {})
+          parsed, options = Telnyx::LlmTokenGateway::TokenGroupListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "llm_token_gateway/token_groups",
+            query: query.transform_keys(
+              page_number: "page[number]",
+              page_size: "page[size]",
+              page_snapshot: "page[snapshot]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::LlmTokenGateway::TokenGroup,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenGroupDeleteParams} for more details.
+        #
+        # Revoke resource and its keys atomically; retain historical attribution, never
+        # detach into an ungoverned service key.
+        #
+        # @overload delete(id, idempotency_key:, if_match:, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param idempotency_key [String] 24h, scoped by account+method+path. Same key/body returns same outcome; changed
+        #
+        # @param if_match [String] Exact quoted resource-version ETag; an exact intermediary-weakened echo W/"n" is
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenGroupDeleteParams
+        def delete(id, params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenGroupDeleteParams.dump_request(params)
+          @client.request(
+            method: :delete,
+            path: ["llm_token_gateway/token_groups/%1$s", id],
+            headers: parsed.transform_keys(idempotency_key: "idempotency-key", if_match: "if-match"),
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/llm_token_gateway/token_keys.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class TokenKeys
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenKeyCreateParams} for more details.
+        #
+        # Create gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. The token secret is returned
+        # only on the original create response. A replay returns metadata without the
+        # secret. Provisioning is advisory; ready is not a guarantee of inference
+        # availability.
+        #
+        # @overload create(name:, token_group_id:, idempotency_key:, allowed_models: nil, blocked: nil, budget_duration: nil, expires_at: nil, max_budget: nil, max_parallel_requests: nil, required_end_user_id: nil, rpm_limit: nil, token_user_id: nil, tpm_limit: nil, request_options: {})
+        #
+        # @param name [String] Body param
+        #
+        # @param token_group_id [String] Body param
+        #
+        # @param idempotency_key [String] Header param: 24h, scoped by account+method+path. Same key/body returns same out
+        #
+        # @param allowed_models [Array<String>, nil] Body param
+        #
+        # @param blocked [Boolean] Body param
+        #
+        # @param budget_duration [Symbol, Telnyx::Models::LlmTokenGateway::BudgetDuration, nil] Body param
+        #
+        # @param expires_at [Time, nil] Body param
+        #
+        # @param max_budget [Float, nil] Body param: USD, decimal precision at most 6 places; parse exactly to integer mi
+        #
+        # @param max_parallel_requests [Integer, nil] Body param: Optional maximum concurrent reserved/dispatched cache misses across
+        #
+        # @param required_end_user_id [Boolean] Body param: Require a nonempty caller-asserted end-user ID; not proof of identit
+        #
+        # @param rpm_limit [Integer, nil] Body param: Omitted or null defaults to the maximum (6000) (on a blocked key, nu
+        #
+        # @param token_user_id [String, nil] Body param
+        #
+        # @param tpm_limit [Integer, nil] Body param: Omitted or null defaults to the maximum (10000000) (on a blocked key
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenKeyResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenKeyCreateParams
+        def create(params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenKeyCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: "llm_token_gateway/token_keys",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::LlmTokenGateway::TokenKeyResponse,
+            options: options
+          )
+        end
+
+        # Get gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String]
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenKeyResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenKeyRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["llm_token_gateway/token_keys/%1$s", id],
+            model: Telnyx::LlmTokenGateway::TokenKeyResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenKeyUpdateParams} for more details.
+        #
+        # Update gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. Omitted fields are preserved.
+        # Null clears max_parallel_requests; null resets budget and rate limits to their
+        # maximum. A stale If-Match returns 412.
+        #
+        # @overload update(id, idempotency_key:, if_match:, allowed_models: nil, blocked: nil, budget_duration: nil, expires_at: nil, max_budget: nil, max_parallel_requests: nil, name: nil, required_end_user_id: nil, rpm_limit: nil, tpm_limit: nil, request_options: {})
+        #
+        # @param id [String] Path param
+        #
+        # @param idempotency_key [String] Header param: 24h, scoped by account+method+path. Same key/body returns same out
+        #
+        # @param if_match [String] Header param: Exact quoted resource-version ETag; an exact intermediary-weakened
+        #
+        # @param allowed_models [Array<String>, nil] Body param
+        #
+        # @param blocked [Boolean] Body param
+        #
+        # @param budget_duration [Symbol, Telnyx::Models::LlmTokenGateway::BudgetDuration, nil] Body param
+        #
+        # @param expires_at [Time, nil] Body param
+        #
+        # @param max_budget [Float, nil] Body param: USD, decimal precision at most 6 places; parse exactly to integer mi
+        #
+        # @param max_parallel_requests [Integer, nil] Body param: Optional maximum concurrent reserved/dispatched cache misses across
+        #
+        # @param name [String] Body param
+        #
+        # @param required_end_user_id [Boolean] Body param: Require a nonempty caller-asserted end-user ID; not proof of identit
+        #
+        # @param rpm_limit [Integer, nil] Body param: Omitted or null defaults to the maximum (6000) (on a blocked key, nu
+        #
+        # @param tpm_limit [Integer, nil] Body param: Omitted or null defaults to the maximum (10000000) (on a blocked key
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::TokenKeyResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenKeyUpdateParams
+        def update(id, params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenKeyUpdateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key", if_match: "if-match"}
+          @client.request(
+            method: :patch,
+            path: ["llm_token_gateway/token_keys/%1$s", id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::LlmTokenGateway::TokenKeyResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenKeyListParams} for more details.
+        #
+        # List gateway token keys within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        #
+        # @overload list(page_number: nil, page_size: nil, page_snapshot: nil, token_group_id: nil, token_user_id: nil, request_options: {})
+        #
+        # @param page_number [Integer]
+        #
+        # @param page_size [Integer]
+        #
+        # @param page_snapshot [String] Required after page 1; account/filter-bound 15-minute stable snapshot; expired/m
+        #
+        # @param token_group_id [String]
+        #
+        # @param token_user_id [String]
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::LlmTokenGateway::TokenKey>]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenKeyListParams
+        def list(params = {})
+          parsed, options = Telnyx::LlmTokenGateway::TokenKeyListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "llm_token_gateway/token_keys",
+            query: query.transform_keys(
+              page_number: "page[number]",
+              page_size: "page[size]",
+              page_snapshot: "page[snapshot]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::LlmTokenGateway::TokenKey,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::TokenKeyDeleteParams} for more details.
+        #
+        # Revoke this token key. Acknowledged revocation blocks new admissions with the
+        # key; requests already admitted may complete. Historical usage attribution is
+        # retained. Other keys in the group are unchanged.
+        #
+        # @overload delete(id, idempotency_key:, if_match:, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param idempotency_key [String] 24h, scoped by account+method+path. Same key/body returns same outcome; changed
+        #
+        # @param if_match [String] Exact quoted resource-version ETag; an exact intermediary-weakened echo W/"n" is
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::TokenKeyDeleteParams
+        def delete(id, params)
+          parsed, options = Telnyx::LlmTokenGateway::TokenKeyDeleteParams.dump_request(params)
+          @client.request(
+            method: :delete,
+            path: ["llm_token_gateway/token_keys/%1$s", id],
+            headers: parsed.transform_keys(idempotency_key: "idempotency-key", if_match: "if-match"),
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/llm_token_gateway/usage.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class Usage
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::UsageRetrieveExportParams} for more details.
+        #
+        # Durable, replayable, content-free usage export for customer pipelines. Requires
+        # the dedicated llm_token_gateway.usage_export.read V2 action; spend.read and
+        # usage.read do not grant it. Records are inference.request (one per immutable
+        # ledger revision; a correction adds a new id with supersedes, keep the highest
+        # revision per request_id) and guardrail.evaluation (one per guardrail event,
+        # including blocked prompts with no inference record; correlate on request_id).
+        # Delivery is at least once in commit order: deduplicate on id. Records appear
+        # after settlement and after every older database transaction has finished
+        # (meta.horizon_lag_seconds); keep polling with next_cursor, which is always
+        # returned and is reusable after has_more is false. After a logical database
+        # restore, restart from start_time and deduplicate on id; a cursor from before it
+        # may return 409 cursor_expired (no Retry-After). Retention promise 30 days. No
+        # prompts, responses, provider credentials, supplier or customer rates. Gateway
+        # reference/enforcement usage, not invoice truth or BYOK provider charges.
+        #
+        # @overload retrieve_export(cursor: nil, limit: nil, start_time: nil, types: nil, request_options: {})
+        #
+        # @param cursor [String] Opaque next_cursor from a previous page; not combinable with start_time. Bound t
+        #
+        # @param limit [Integer]
+        #
+        # @param start_time [Time] First page only: RFC 3339 with offset, at most 30 days ago and not in the future
+        #
+        # @param types [String] Comma-separated subset of inference.request,guardrail.evaluation; default both.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::UsageRetrieveExportResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::UsageRetrieveExportParams
+        def retrieve_export(params = {})
+          parsed, options = Telnyx::LlmTokenGateway::UsageRetrieveExportParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "llm_token_gateway/usage/export",
+            query: query,
+            model: Telnyx::Models::LlmTokenGateway::UsageRetrieveExportResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::LlmTokenGateway::UsageRetrieveSummaryParams} for more details.
+        #
+        # Gateway reference/enforcement usage, not invoice truth or BYOK provider charges.
+        # Requires the dedicated llm_token_gateway.usage.read V2 action for combined spend
+        # and guardrail reporting; existing spend.read and guardrail_events.read grants do
+        # not grant this endpoint. All totals, UTC daily buckets, models and latest 20
+        # guardrail events share one database snapshot. UTC half-open dates, at most 31
+        # days. Zero-filled days; at most 1000 models (503 rather than truncation on
+        # overflow/timeout). Known tokens sum independently known categories across latest
+        # attempt evidence, including corrections; unknown spend is excluded and
+        # unknown_requests/reserved_spend remain explicit. Guardrail counts count events,
+        # not distinct requests. No raw spend events, prompts or secrets. This read-only
+        # report creates no pagination snapshot and accepts no pagination parameters.
+        #
+        # @overload retrieve_summary(end_date:, start_date:, token_group_id:, metadata: nil, request_options: {})
+        #
+        # @param end_date [Date]
+        #
+        # @param start_date [Date]
+        #
+        # @param token_group_id [String]
+        #
+        # @param metadata [Hash{Symbol=>String}] Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::LlmTokenGateway::UsageRetrieveSummaryResponse]
+        #
+        # @see Telnyx::Models::LlmTokenGateway::UsageRetrieveSummaryParams
+        def retrieve_summary(params)
+          parsed, options = Telnyx::LlmTokenGateway::UsageRetrieveSummaryParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "llm_token_gateway/usage/summary",
+            query: query,
+            model: Telnyx::Models::LlmTokenGateway::UsageRetrieveSummaryResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/llm_token_gateway.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      # @return [Telnyx::Resources::LlmTokenGateway::Usage]
+      attr_reader :usage
+
+      # Manage and report AI Gateway usage.
+      # @return [Telnyx::Resources::LlmTokenGateway::Spend]
+      attr_reader :spend
+
+      # Manage and report AI Gateway usage.
+      # @return [Telnyx::Resources::LlmTokenGateway::TokenGroups]
+      attr_reader :token_groups
+
+      # Manage and report AI Gateway usage.
+      # @return [Telnyx::Resources::LlmTokenGateway::TokenKeys]
+      attr_reader :token_keys
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @usage = Telnyx::Resources::LlmTokenGateway::Usage.new(client: client)
+        @spend = Telnyx::Resources::LlmTokenGateway::Spend.new(client: client)
+        @token_groups = Telnyx::Resources::LlmTokenGateway::TokenGroups.new(client: client)
+        @token_keys = Telnyx::Resources::LlmTokenGateway::TokenKeys.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/meeting_sessions.rb

@@ -168,12 +168,12 @@ module Telnyx
         )
       end
 
-      # Irreversibly requests deletion of provider-hosted aggregate recording media
-      # under the provider contract. The operation retains the Telnyx-local Meeting
-      # session, transcript segments, events, artifacts, and usage records. It is
-      # separate from `DELETE /meeting_sessions/{id}`, which stops or cancels
-      # participation without deleting the persisted session. A missing/foreign session
-      # returns 404; provider deletion failures return 502.
+      # Irreversibly requests deletion of the aggregate recording media for the session.
+      # The operation retains the Telnyx-local Meeting session, transcript segments,
+      # events, artifacts, and usage records. It is separate from
+      # `DELETE /meeting_sessions/{id}`, which stops or cancels participation without
+      # deleting the persisted session. A missing/foreign session returns 404; provider
+      # deletion failures return 502.
       #
       # @overload delete_recording_media(id, request_options: {})
       #

data/lib/telnyx/resources/phone_numbers/jobs.rb

@@ -30,9 +30,10 @@ module Telnyx
         # {Telnyx::Models::PhoneNumbers::JobListParams} for more details.
         #
         # Returns background jobs that operate on phone numbers. Filter by job type,
-        # target phone numbers, or job status, and sort by creation time. Multiple
-        # phone-number or status values use OR semantics within that filter; different
-        # filter categories use AND semantics. Results include pagination metadata.
+        # target phone numbers, job status, or creation-time customer reference, and sort
+        # by creation time. Multiple phone-number or status values use OR semantics within
+        # that filter; different filter categories use AND semantics. Results include
+        # pagination metadata.
         #
         # @overload list(filter: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
         #

data/lib/telnyx/resources/reputation/numbers.rb

@@ -41,14 +41,18 @@ module Telnyx
         # that returns numbers across every enterprise you own. Useful when you don't want
         # to look up the enterprise id first.
         #
-        # @overload list(filter_enterprise_id: nil, filter_phone_number_contains: nil, filter_phone_number_eq: nil, page_number: nil, page_size: nil, request_options: {})
+        # @overload list(filter_enterprise_id: nil, filter_ownership_status: nil, filter_phone_number_contains: nil, filter_phone_number_eq: nil, filter_source: nil, page_number: nil, page_size: nil, request_options: {})
         #
         # @param filter_enterprise_id [String] Filter by enterprise ID.
         #
+        # @param filter_ownership_status [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus] Only numbers with this ownership status. `removed` lists the numbers that were r
+        #
         # @param filter_phone_number_contains [String] Partial match on phone number. Must contain at least 5 digits.
         #
         # @param filter_phone_number_eq [String] Exact phone-number match (E.164).
         #
+        # @param filter_source [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource] Only numbers with this source.
+        #
         # @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
         #
         # @param page_size [Integer] Items per page. Maximum 250; values above are clamped to 250.
@@ -66,8 +70,10 @@ module Telnyx
             path: "reputation/numbers",
             query: query.transform_keys(
               filter_enterprise_id: "filter[enterprise_id]",
+              filter_ownership_status: "filter[ownership_status]",
               filter_phone_number_contains: "filter[phone_number][contains]",
               filter_phone_number_eq: "filter[phone_number][eq]",
+              filter_source: "filter[source]",
               page_number: "page[number]",
               page_size: "page[size]"
             ),