telnyx 5.174.0 → 5.175.0

data/lib/telnyx/models/agent_gateways/agent_gateway_policy_step.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      class AgentGatewayPolicyStep < Telnyx::Internal::Type::BaseModel
+        # @!attribute guardrail
+        #   A guardrail on the instance, by name.
+        #
+        #   @return [String]
+        required :guardrail, String
+
+        # @!attribute message
+        #   The response that replaces the model's when an outcome is `respond`. Required
+        #   with `respond`.
+        #
+        #   @return [String, nil]
+        optional :message, String, nil?: true
+
+        # @!attribute on_error
+        #   What happens when the guardrail errors. Left out, the same as `on_fail`.
+        #
+        #   @return [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnError, nil]
+        optional :on_error, enum: -> { Telnyx::AgentGateways::AgentGatewayPolicyStep::OnError }, nil?: true
+
+        # @!attribute on_fail
+        #   What happens when the guardrail fails.
+        #
+        #   @return [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnFail, nil]
+        optional :on_fail, enum: -> { Telnyx::AgentGateways::AgentGatewayPolicyStep::OnFail }
+
+        # @!attribute on_pass
+        #   What happens when the guardrail passes. `next` goes on to the next step, `allow`
+        #   allows the request, `block` blocks it, and `respond` answers with `message`.
+        #
+        #   @return [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnPass, nil]
+        optional :on_pass, enum: -> { Telnyx::AgentGateways::AgentGatewayPolicyStep::OnPass }
+
+        # @!attribute pass_data
+        #   `true` hands the step's modified request, such as masked text, to the next step.
+        #
+        #   @return [Boolean, nil]
+        optional :pass_data, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(guardrail:, message: nil, on_error: nil, on_fail: nil, on_pass: nil, pass_data: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::AgentGatewayPolicyStep} for more details.
+        #
+        #   One pipeline step: a guardrail, and what happens when it passes, fails, or
+        #   errors.
+        #
+        #   @param guardrail [String] A guardrail on the instance, by name.
+        #
+        #   @param message [String, nil] The response that replaces the model's when an outcome is `respond`. Required wi
+        #
+        #   @param on_error [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnError, nil] What happens when the guardrail errors. Left out, the same as `on_fail`.
+        #
+        #   @param on_fail [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnFail] What happens when the guardrail fails.
+        #
+        #   @param on_pass [Symbol, Telnyx::Models::AgentGateways::AgentGatewayPolicyStep::OnPass] What happens when the guardrail passes. `next` goes on to the next step, `allow`
+        #
+        #   @param pass_data [Boolean] `true` hands the step's modified request, such as masked text, to the next step.
+
+        # What happens when the guardrail errors. Left out, the same as `on_fail`.
+        #
+        # @see Telnyx::Models::AgentGateways::AgentGatewayPolicyStep#on_error
+        module OnError
+          extend Telnyx::Internal::Type::Enum
+
+          NEXT = :next
+          ALLOW = :allow
+          BLOCK = :block
+          RESPOND = :respond
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # What happens when the guardrail fails.
+        #
+        # @see Telnyx::Models::AgentGateways::AgentGatewayPolicyStep#on_fail
+        module OnFail
+          extend Telnyx::Internal::Type::Enum
+
+          NEXT = :next
+          ALLOW = :allow
+          BLOCK = :block
+          RESPOND = :respond
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # What happens when the guardrail passes. `next` goes on to the next step, `allow`
+        # allows the request, `block` blocks it, and `respond` answers with `message`.
+        #
+        # @see Telnyx::Models::AgentGateways::AgentGatewayPolicyStep#on_pass
+        module OnPass
+          extend Telnyx::Internal::Type::Enum
+
+          NEXT = :next
+          ALLOW = :allow
+          BLOCK = :block
+          RESPOND = :respond
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    AgentGatewayPolicyStep = AgentGateways::AgentGatewayPolicyStep
+  end
+end

data/lib/telnyx/models/agent_gateways/agent_gateway_shown_auth.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      class AgentGatewayShownAuth < Telnyx::Internal::Type::BaseModel
+        # @!attribute type
+        #   The method's `type`.
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!method initialize(type:)
+        #   The server's outbound authentication method. Credentials are never returned.
+        #
+        #   @param type [String] The method's `type`.
+      end
+    end
+
+    AgentGatewayShownAuth = AgentGateways::AgentGatewayShownAuth
+  end
+end

data/lib/telnyx/models/agent_gateways/agent_gateway_static_auth.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      class AgentGatewayStaticAuth < Telnyx::Internal::Type::BaseModel
+        # @!attribute type
+        #   How the credential is sent: `api_key` as `X-API-Key: <value>`, `bearer_token` as
+        #   `Authorization: Bearer <value>`, `basic` as
+        #   `Authorization: Basic <base64 of value>` with `value` in the form
+        #   `user:password`, `token` as `Authorization: token <value>`, and `authorization`
+        #   as `Authorization: <value>`.
+        #
+        #   @return [Symbol, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth::Type]
+        required :type, enum: -> { Telnyx::AgentGateways::AgentGatewayStaticAuth::Type }
+
+        # @!attribute header
+        #   A header name that replaces `X-API-Key` or `Authorization`.
+        #
+        #   @return [String, nil]
+        optional :header, String, nil?: true
+
+        request_only do
+          # @!attribute value
+          #   The credential.
+          #
+          #   @return [String]
+          required :value, String
+        end
+
+        # @!method initialize(type:, value:, header: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::AgentGatewayStaticAuth} for more details.
+        #
+        #   A static credential the gateway sends on every request. Write-only: responses
+        #   show its `type` only.
+        #
+        #   @param type [Symbol, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth::Type] How the credential is sent: `api_key` as `X-API-Key: <value>`, `bearer_token` as
+        #
+        #   @param value [String] The credential.
+        #
+        #   @param header [String, nil] A header name that replaces `X-API-Key` or `Authorization`.
+
+        # How the credential is sent: `api_key` as `X-API-Key: <value>`, `bearer_token` as
+        # `Authorization: Bearer <value>`, `basic` as
+        # `Authorization: Basic <base64 of value>` with `value` in the form
+        # `user:password`, `token` as `Authorization: token <value>`, and `authorization`
+        # as `Authorization: <value>`.
+        #
+        # @see Telnyx::Models::AgentGateways::AgentGatewayStaticAuth#type
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          API_KEY = :api_key
+          BEARER_TOKEN = :bearer_token
+          BASIC = :basic
+          TOKEN = :token
+          AUTHORIZATION = :authorization
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    AgentGatewayStaticAuth = AgentGateways::AgentGatewayStaticAuth
+  end
+end

data/lib/telnyx/models/agent_gateways/agent_gateway_team.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      class AgentGatewayTeam < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifies the team.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute blocked
+        #   Whether the instance refuses every key in the team.
+        #
+        #   @return [Boolean]
+        required :blocked, Telnyx::Internal::Type::Boolean
+
+        # @!attribute budget_resets_at
+        #   When the team's spend next resets.
+        #
+        #   @return [Time, nil]
+        required :budget_resets_at, Time, nil?: true
+
+        # @!attribute budget_resets_every
+        #   How often the team's spend resets, such as `30d`.
+        #
+        #   @return [String, nil]
+        required :budget_resets_every, String, nil?: true
+
+        # @!attribute created_at
+        #   When the team was created.
+        #
+        #   @return [Time, nil]
+        required :created_at, Time, nil?: true
+
+        # @!attribute max_budget
+        #   The most the team's keys may spend together, in USD, until the budget resets.
+        #
+        #   @return [Float, nil]
+        required :max_budget, Float, nil?: true
+
+        # @!attribute models
+        #   The models the team's keys may use. Empty means every model the instance serves.
+        #
+        #   @return [Array<String>]
+        required :models, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute name
+        #   A label for people. Names need not be unique.
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!attribute requests_per_minute
+        #   The most requests the team's keys may make per minute, together.
+        #
+        #   @return [Integer, nil]
+        required :requests_per_minute, Integer, nil?: true
+
+        # @!attribute spend
+        #   What the team's keys have spent since the budget last reset, in USD.
+        #
+        #   @return [Float]
+        required :spend, Float
+
+        # @!attribute tokens_per_minute
+        #   The most tokens the team's keys may use per minute, together.
+        #
+        #   @return [Integer, nil]
+        required :tokens_per_minute, Integer, nil?: true
+
+        # @!method initialize(id:, blocked:, budget_resets_at:, budget_resets_every:, created_at:, max_budget:, models:, name:, requests_per_minute:, spend:, tokens_per_minute:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::AgentGatewayTeam} for more details.
+        #
+        #   A team on an instance: a model list, a budget, and rate limits that its keys
+        #   share.
+        #
+        #   @param id [String] Identifies the team.
+        #
+        #   @param blocked [Boolean] Whether the instance refuses every key in the team.
+        #
+        #   @param budget_resets_at [Time, nil] When the team's spend next resets.
+        #
+        #   @param budget_resets_every [String, nil] How often the team's spend resets, such as `30d`.
+        #
+        #   @param created_at [Time, nil] When the team was created.
+        #
+        #   @param max_budget [Float, nil] The most the team's keys may spend together, in USD, until the budget resets.
+        #
+        #   @param models [Array<String>] The models the team's keys may use. Empty means every model the instance serves.
+        #
+        #   @param name [String, nil] A label for people. Names need not be unique.
+        #
+        #   @param requests_per_minute [Integer, nil] The most requests the team's keys may make per minute, together.
+        #
+        #   @param spend [Float] What the team's keys have spent since the budget last reset, in USD.
+        #
+        #   @param tokens_per_minute [Integer, nil] The most tokens the team's keys may use per minute, together.
+      end
+    end
+
+    AgentGatewayTeam = AgentGateways::AgentGatewayTeam
+  end
+end

data/lib/telnyx/models/agent_gateways/agent_gateway_team_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      # @see Telnyx::Resources::AgentGateways::Teams#create
+      class AgentGatewayTeamResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   A team on an instance: a model list, a budget, and rate limits that its keys
+        #   share.
+        #
+        #   @return [Telnyx::Models::AgentGateways::AgentGatewayTeam]
+        required :data, -> { Telnyx::AgentGateways::AgentGatewayTeam }
+
+        # @!method initialize(data:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::AgentGatewayTeamResponse} for more details.
+        #
+        #   @param data [Telnyx::Models::AgentGateways::AgentGatewayTeam] A team on an instance: a model list, a budget, and rate limits that its keys sha
+      end
+    end
+
+    AgentGatewayTeamResponse = AgentGateways::AgentGatewayTeamResponse
+  end
+end

data/lib/telnyx/models/agent_gateways/api_create_params.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      # @see Telnyx::Resources::AgentGateways::APIs#create
+      class APICreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute instance_id
+        #
+        #   @return [String]
+        required :instance_id, String
+
+        # @!attribute name
+        #   A name for the API, unique on the instance across MCP servers and APIs,
+        #   regardless of case. Up to 100 letters, digits, `_`, and `.`. The gateway
+        #   prefixes the API's tools with it and a hyphen.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute spec_url
+        #   The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1, or Swagger
+        #   2.0.
+        #
+        #   @return [String]
+        required :spec_url, String
+
+        # @!attribute auth
+        #   How the gateway authenticates to the API. AWS Signature Version 4 is for MCP
+        #   servers only. Replaced whole on an update.
+        #
+        #   @return [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth, nil]
+        optional :auth, union: -> { Telnyx::AgentGateways::APICreateParams::Auth }
+
+        # @!attribute base_url
+        #   Where the gateway sends the API's requests. Without it, the gateway takes the
+        #   description's first `servers` entry.
+        #
+        #   @return [String, nil]
+        optional :base_url, String, nil?: true
+
+        # @!attribute forwarded_headers
+        #   Headers copied from the agent's request, by name.
+        #
+        #   @return [Array<String>, nil]
+        optional :forwarded_headers, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute open_to_every_key
+        #   `true` lets every key on the instance use the server, granted or not.
+        #
+        #   @return [Boolean, nil]
+        optional :open_to_every_key, Telnyx::Internal::Type::Boolean
+
+        # @!attribute static_headers
+        #   Headers sent on every request.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :static_headers, Telnyx::Internal::Type::HashOf[String]
+
+        # @!attribute tools
+        #   The operations the API exposes as tools, by tool name. `[]` exposes every
+        #   operation.
+        #
+        #   @return [Array<String>, nil]
+        optional :tools, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(instance_id:, name:, spec_url:, auth: nil, base_url: nil, forwarded_headers: nil, open_to_every_key: nil, static_headers: nil, tools: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::APICreateParams} for more details.
+        #
+        #   @param instance_id [String]
+        #
+        #   @param name [String] A name for the API, unique on the instance across MCP servers and APIs, regardle
+        #
+        #   @param spec_url [String] The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1, or Swagger 2
+        #
+        #   @param auth [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth] How the gateway authenticates to the API. AWS Signature Version 4 is for MCP ser
+        #
+        #   @param base_url [String, nil] Where the gateway sends the API's requests. Without it, the gateway takes the de
+        #
+        #   @param forwarded_headers [Array<String>] Headers copied from the agent's request, by name.
+        #
+        #   @param open_to_every_key [Boolean] `true` lets every key on the instance use the server, granted or not.
+        #
+        #   @param static_headers [Hash{Symbol=>String}] Headers sent on every request.
+        #
+        #   @param tools [Array<String>] The operations the API exposes as tools, by tool name. `[]` exposes every operat
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # How the gateway authenticates to the API. AWS Signature Version 4 is for MCP
+        # servers only. Replaced whole on an update.
+        module Auth
+          extend Telnyx::Internal::Type::Union
+
+          # The gateway sends no credential.
+          variant -> { Telnyx::AgentGateways::AgentGatewayNoAuth }
+
+          # A static credential the gateway sends on every request. Write-only: responses show its `type` only.
+          variant -> { Telnyx::AgentGateways::AgentGatewayStaticAuth }
+
+          # The gateway gets its own access token with the `client_credentials` grant and sends it as a bearer token on every request, renewing it before it expires. The client ID and secret are write-only.
+          variant -> { Telnyx::AgentGateways::AgentGatewayOAuthClientCredentials }
+
+          # The gateway forwards the agent's own `Authorization` header to the server unchanged.
+          variant -> { Telnyx::AgentGateways::AgentGatewayPassthroughAuth }
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth)]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/agent_gateways/api_delete_params.rb

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

data/lib/telnyx/models/agent_gateways/api_list_params.rb

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

data/lib/telnyx/models/agent_gateways/api_list_response.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      # @see Telnyx::Resources::AgentGateways::APIs#list
+      class APIListResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<Telnyx::Models::AgentGateways::AgentGatewayAPI>]
+        required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AgentGateways::AgentGatewayAPI] }
+
+        # @!method initialize(data:)
+        #   @param data [Array<Telnyx::Models::AgentGateways::AgentGatewayAPI>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/agent_gateways/api_update_params.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AgentGateways
+      # @see Telnyx::Resources::AgentGateways::APIs#update
+      class APIUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute instance_id
+        #
+        #   @return [String]
+        required :instance_id, String
+
+        # @!attribute api_id
+        #
+        #   @return [String]
+        required :api_id, String
+
+        # @!attribute auth
+        #   How the gateway authenticates to the API. AWS Signature Version 4 is for MCP
+        #   servers only. Replaced whole on an update.
+        #
+        #   @return [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth, nil]
+        optional :auth, union: -> { Telnyx::AgentGateways::APIUpdateParams::Auth }
+
+        # @!attribute base_url
+        #   Where the gateway sends the API's requests. Without it, the gateway takes the
+        #   description's first `servers` entry.
+        #
+        #   @return [String, nil]
+        optional :base_url, String, nil?: true
+
+        # @!attribute forwarded_headers
+        #   Headers copied from the agent's request, by name.
+        #
+        #   @return [Array<String>, nil]
+        optional :forwarded_headers, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute name
+        #   A name for the API, unique on the instance across MCP servers and APIs,
+        #   regardless of case. Letters, digits, `_`, and `.`. The gateway prefixes the
+        #   API's tools with it and a hyphen.
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute open_to_every_key
+        #   `true` lets every key on the instance use the server, granted or not.
+        #
+        #   @return [Boolean, nil]
+        optional :open_to_every_key, Telnyx::Internal::Type::Boolean
+
+        # @!attribute spec_url
+        #   The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1, or Swagger
+        #   2.0.
+        #
+        #   @return [String, nil]
+        optional :spec_url, String
+
+        # @!attribute static_headers
+        #   Headers sent on every request.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :static_headers, Telnyx::Internal::Type::HashOf[String]
+
+        # @!attribute tools
+        #   The operations the API exposes as tools, by tool name. `[]` exposes every
+        #   operation.
+        #
+        #   @return [Array<String>, nil]
+        optional :tools, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(instance_id:, api_id:, auth: nil, base_url: nil, forwarded_headers: nil, name: nil, open_to_every_key: nil, spec_url: nil, static_headers: nil, tools: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AgentGateways::APIUpdateParams} for more details.
+        #
+        #   @param instance_id [String]
+        #
+        #   @param api_id [String]
+        #
+        #   @param auth [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth] How the gateway authenticates to the API. AWS Signature Version 4 is for MCP ser
+        #
+        #   @param base_url [String, nil] Where the gateway sends the API's requests. Without it, the gateway takes the de
+        #
+        #   @param forwarded_headers [Array<String>] Headers copied from the agent's request, by name.
+        #
+        #   @param name [String] A name for the API, unique on the instance across MCP servers and APIs, regardle
+        #
+        #   @param open_to_every_key [Boolean] `true` lets every key on the instance use the server, granted or not.
+        #
+        #   @param spec_url [String] The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1, or Swagger 2
+        #
+        #   @param static_headers [Hash{Symbol=>String}] Headers sent on every request.
+        #
+        #   @param tools [Array<String>] The operations the API exposes as tools, by tool name. `[]` exposes every operat
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # How the gateway authenticates to the API. AWS Signature Version 4 is for MCP
+        # servers only. Replaced whole on an update.
+        module Auth
+          extend Telnyx::Internal::Type::Union
+
+          # The gateway sends no credential.
+          variant -> { Telnyx::AgentGateways::AgentGatewayNoAuth }
+
+          # A static credential the gateway sends on every request. Write-only: responses show its `type` only.
+          variant -> { Telnyx::AgentGateways::AgentGatewayStaticAuth }
+
+          # The gateway gets its own access token with the `client_credentials` grant and sends it as a bearer token on every request, renewing it before it expires. The client ID and secret are write-only.
+          variant -> { Telnyx::AgentGateways::AgentGatewayOAuthClientCredentials }
+
+          # The gateway forwards the agent's own `Authorization` header to the server unchanged.
+          variant -> { Telnyx::AgentGateways::AgentGatewayPassthroughAuth }
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth)]
+        end
+      end
+    end
+  end
+end