telnyx 5.174.0 → 5.175.0

data/lib/telnyx/resources/agent_gateways/apis.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # REST APIs on an instance, served to agents as tools.
+      class APIs
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::APICreateParams} for more details.
+        #
+        # Adds a REST API by its OpenAPI description. Each operation becomes a tool at
+        # `{gateway_url}/mcp`, named with the API's `name`, a hyphen, and the lowercased
+        # `operationId`. A description the gateway cannot fetch yields an API with no
+        # tools. The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload create(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: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @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}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayAPIResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::APICreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::APICreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/apis", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayAPIResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::APIUpdateParams} for more details.
+        #
+        # Changes an API's settings. A field left out stays as it is, `"base_url": null`
+        # clears the base URL, and `auth` is replaced whole. The instance must be `ready`;
+        # otherwise the request answers `409`.
+        #
+        # @overload update(api_id, instance_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: {})
+        #
+        # @param api_id [String] Path param: The API's `id`.
+        #
+        # @param instance_id [String] Path param: The Agent Gateway's `id`.
+        #
+        # @param auth [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth] Body param: How the gateway authenticates to the API. AWS Signature Version 4 is
+        #
+        # @param base_url [String, nil] Body param: Where the gateway sends the API's requests. Without it, the gateway
+        #
+        # @param forwarded_headers [Array<String>] Body param: Headers copied from the agent's request, by name.
+        #
+        # @param name [String] Body param: A name for the API, unique on the instance across MCP servers and AP
+        #
+        # @param open_to_every_key [Boolean] Body param: `true` lets every key on the instance use the server, granted or not
+        #
+        # @param spec_url [String] Body param: The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1,
+        #
+        # @param static_headers [Hash{Symbol=>String}] Body param: Headers sent on every request.
+        #
+        # @param tools [Array<String>] Body param: The operations the API exposes as tools, by tool name. `[]` exposes
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayAPIResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::APIUpdateParams
+        def update(api_id, params)
+          parsed, options = Telnyx::AgentGateways::APIUpdateParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["agent_gateways/%1$s/apis/%2$s", instance_id, api_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayAPIResponse,
+            options: options
+          )
+        end
+
+        # Lists the REST APIs the instance serves as tools, without their credentials. The
+        # instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload list(instance_id, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::APIListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::APIListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/apis", instance_id],
+            model: Telnyx::Models::AgentGateways::APIListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Removes an API and returns it as it was. An MCP server's `id` answers `404`. The
+        # instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload delete(api_id, instance_id:, request_options: {})
+        #
+        # @param api_id [String] The API's `id`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayAPIResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::APIDeleteParams
+        def delete(api_id, params)
+          parsed, options = Telnyx::AgentGateways::APIDeleteParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["agent_gateways/%1$s/apis/%2$s", instance_id, api_id],
+            model: Telnyx::AgentGateways::AgentGatewayAPIResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/agent_gateways/guardrails.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Checks an instance runs on model and tool requests.
+      class Guardrails
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::GuardrailCreateParams} for more details.
+        #
+        # Adds a check the instance runs on model and tool requests. It runs on every
+        # request when `always_on`, and otherwise on the requests that name it in
+        # `guardrails`. The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload create(instance_id, modes:, name:, type:, always_on: nil, settings: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param modes [Array<Symbol, Telnyx::Models::AgentGateways::GuardrailCreateParams::Mode>] When the guardrail runs. Each type runs in some modes only.
+        #
+        # @param name [String] A name, unique on the instance. A request names it in its `guardrails` field.
+        #
+        # @param type [Symbol, Telnyx::Models::AgentGateways::GuardrailCreateParams::Type] The kind of check. It cannot change after create.
+        #
+        # @param always_on [Boolean] `true` runs the guardrail on every request, and a request cannot turn it off. `f
+        #
+        # @param settings [Hash{Symbol=>Object}] The type's settings. `content_filter`: `patterns` (prebuilt patterns by `name`,
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayGuardrailResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::GuardrailCreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::GuardrailCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/guardrails", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayGuardrailResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::GuardrailUpdateParams} for more details.
+        #
+        # Changes a guardrail's `name`, `modes`, `always_on`, or `settings`. `settings` is
+        # replaced whole, secrets included. The `type` cannot change. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        #
+        # @overload update(guardrail_id, instance_id:, always_on: nil, modes: nil, name: nil, settings: nil, request_options: {})
+        #
+        # @param guardrail_id [String] Path param: The guardrail's `id`.
+        #
+        # @param instance_id [String] Path param: The Agent Gateway's `id`.
+        #
+        # @param always_on [Boolean] Body param: `true` runs the guardrail on every request, and a request cannot tur
+        #
+        # @param modes [Array<Symbol, Telnyx::Models::AgentGateways::GuardrailUpdateParams::Mode>] Body param: When the guardrail runs. Each type runs in some modes only.
+        #
+        # @param name [String] Body param: A name, unique on the instance. A request names it in its `guardrail
+        #
+        # @param settings [Hash{Symbol=>Object}] Body param: The type's settings. `content_filter`: `patterns` (prebuilt patterns
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayGuardrailResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::GuardrailUpdateParams
+        def update(guardrail_id, params)
+          parsed, options = Telnyx::AgentGateways::GuardrailUpdateParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["agent_gateways/%1$s/guardrails/%2$s", instance_id, guardrail_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayGuardrailResponse,
+            options: options
+          )
+        end
+
+        # Lists the instance's guardrails, without their secrets. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        #
+        # @overload list(instance_id, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::GuardrailListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::GuardrailListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/guardrails", instance_id],
+            model: Telnyx::Models::AgentGateways::GuardrailListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Removes a guardrail and returns it as it was. The instance must be `ready`;
+        # otherwise the request answers `409`.
+        #
+        # @overload delete(guardrail_id, instance_id:, request_options: {})
+        #
+        # @param guardrail_id [String] The guardrail's `id`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayGuardrailResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::GuardrailDeleteParams
+        def delete(guardrail_id, params)
+          parsed, options = Telnyx::AgentGateways::GuardrailDeleteParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["agent_gateways/%1$s/guardrails/%2$s", instance_id, guardrail_id],
+            model: Telnyx::AgentGateways::AgentGatewayGuardrailResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/agent_gateways/keys/tool_permissions.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      class Keys
+        # The MCP servers and tools a key or team may use.
+        class ToolPermissions
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AgentGateways::Keys::ToolPermissionCreateParams} for more
+          # details.
+          #
+          # Replaces the grant whole and returns it. Every server must be one of the
+          # instance's MCP servers or APIs, named once. A key reaches the servers granted to
+          # it or to its team, and the servers open to every key; when both grant, only the
+          # servers in both. The instance must be `ready`; otherwise the request answers
+          # `409`.
+          #
+          # @overload create(key_id, instance_id:, servers:, request_options: {})
+          #
+          # @param key_id [String] Path param: The key's `id`, a 64-character hash the instance stores in place of
+          #
+          # @param instance_id [String] Path param: The Agent Gateway's `id`.
+          #
+          # @param servers [Array<Telnyx::Models::AgentGateways::Keys::AgentGatewayToolPermissions::Server>] Body param: The servers granted, each with its tools. `[]` grants none.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AgentGateways::Keys::AgentGatewayToolPermissionsResponse]
+          #
+          # @see Telnyx::Models::AgentGateways::Keys::ToolPermissionCreateParams
+          def create(key_id, params)
+            parsed, options = Telnyx::AgentGateways::Keys::ToolPermissionCreateParams.dump_request(params)
+            instance_id =
+              parsed.delete(:instance_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :put,
+              path: ["agent_gateways/%1$s/keys/%2$s/tool_permissions", instance_id, key_id],
+              body: parsed,
+              model: Telnyx::AgentGateways::Keys::AgentGatewayToolPermissionsResponse,
+              options: options
+            )
+          end
+
+          # Returns the MCP servers and APIs the key may use, and the tools within each.
+          # `servers: []` means none. The instance must be `ready`; otherwise the request
+          # answers `409`.
+          #
+          # @overload list(key_id, instance_id:, request_options: {})
+          #
+          # @param key_id [String] The key's `id`, a 64-character hash the instance stores in place of the key.
+          #
+          # @param instance_id [String] The Agent Gateway's `id`.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AgentGateways::Keys::AgentGatewayToolPermissionsResponse]
+          #
+          # @see Telnyx::Models::AgentGateways::Keys::ToolPermissionListParams
+          def list(key_id, params)
+            parsed, options = Telnyx::AgentGateways::Keys::ToolPermissionListParams.dump_request(params)
+            instance_id =
+              parsed.delete(:instance_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["agent_gateways/%1$s/keys/%2$s/tool_permissions", instance_id, key_id],
+              model: Telnyx::AgentGateways::Keys::AgentGatewayToolPermissionsResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/agent_gateways/keys.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Keys on an instance.
+      class Keys
+        # The MCP servers and tools a key or team may use.
+        # @return [Telnyx::Resources::AgentGateways::Keys::ToolPermissions]
+        attr_reader :tool_permissions
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::KeyCreateParams} for more details.
+        #
+        # Issues a key on the instance. The key's value is in this response only. Every
+        # field is optional; a key without `models` may use every model the instance
+        # serves. The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload create(instance_id, budget_resets_every: nil, expires_in: nil, max_budget: nil, max_parallel_requests: nil, models: nil, name: nil, requests_per_minute: nil, team_id: nil, tokens_per_minute: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param budget_resets_every [String, nil] How often the spend resets: a number and a unit, `s`, `m`, `h`, or `d`.
+        #
+        # @param expires_in [String, nil] How long until the key stops working: a number and a unit, `s`, `m`, `h`, or `d`
+        #
+        # @param max_budget [Float, nil] The most the key may spend, in USD.
+        #
+        # @param max_parallel_requests [Integer, nil] The most requests the key may have in flight at once.
+        #
+        # @param models [Array<String>, nil] The models the key may use. Leave it out to allow every model.
+        #
+        # @param name [String, nil] A label for people, unique on the instance.
+        #
+        # @param requests_per_minute [Integer, nil] The most requests the key may make per minute.
+        #
+        # @param team_id [String, nil] A team on the instance. The key shares the team's model list, budget, and rate l
+        #
+        # @param tokens_per_minute [Integer, nil] The most tokens the key may use per minute.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::KeyCreateResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::KeyCreateParams
+        def create(instance_id, params = {})
+          parsed, options = Telnyx::AgentGateways::KeyCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/keys", instance_id],
+            body: parsed,
+            model: Telnyx::Models::AgentGateways::KeyCreateResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::KeyUpdateParams} for more details.
+        #
+        # Changes a key's settings without reissuing it. A field left out stays as it is,
+        # and `null` clears it. `models: []` lifts the model restriction. `expires_in`
+        # counts from now. Setting `blocked` to `true` makes the instance refuse the key
+        # with `401` while keeping its settings and spend; `false` lets it through again.
+        # The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload update(key_id, instance_id:, blocked: nil, budget_resets_every: nil, expires_in: nil, max_budget: nil, max_parallel_requests: nil, models: nil, name: nil, requests_per_minute: nil, team_id: nil, tokens_per_minute: nil, request_options: {})
+        #
+        # @param key_id [String] Path param: The key's `id`, a 64-character hash the instance stores in place of
+        #
+        # @param instance_id [String] Path param: The Agent Gateway's `id`.
+        #
+        # @param blocked [Boolean] Body param: `true` makes the instance refuse the key; `false` lets it through ag
+        #
+        # @param budget_resets_every [String, nil] Body param: How often the spend resets.
+        #
+        # @param expires_in [String, nil] Body param: How long from now until the key stops working.
+        #
+        # @param max_budget [Float, nil] Body param: The most the key may spend, in USD.
+        #
+        # @param max_parallel_requests [Integer, nil] Body param: The most requests the key may have in flight at once.
+        #
+        # @param models [Array<String>] Body param: The models the key may use. `[]` allows every model.
+        #
+        # @param name [String] Body param: A label for people.
+        #
+        # @param requests_per_minute [Integer, nil] Body param: The most requests the key may make per minute.
+        #
+        # @param team_id [String, nil] Body param: Move the key to this team, or `null` to leave its team.
+        #
+        # @param tokens_per_minute [Integer, nil] Body param: The most tokens the key may use per minute.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayKeyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::KeyUpdateParams
+        def update(key_id, params)
+          parsed, options = Telnyx::AgentGateways::KeyUpdateParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["agent_gateways/%1$s/keys/%2$s", instance_id, key_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayKeyResponse,
+            options: options
+          )
+        end
+
+        # Lists the instance's keys, without their values. Returns the first 100. The
+        # instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload list(instance_id, team_id: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param team_id [String] Only the keys of this team.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::KeyListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::KeyListParams
+        def list(instance_id, params = {})
+          parsed, options = Telnyx::AgentGateways::KeyListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/keys", instance_id],
+            query: query,
+            model: Telnyx::Models::AgentGateways::KeyListResponse,
+            options: options
+          )
+        end
+
+        # Revokes a key and returns it as it was, without its value. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        #
+        # @overload delete(key_id, instance_id:, request_options: {})
+        #
+        # @param key_id [String] The key's `id`, a 64-character hash the instance stores in place of the key.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayKeyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::KeyDeleteParams
+        def delete(key_id, params)
+          parsed, options = Telnyx::AgentGateways::KeyDeleteParams.dump_request(params)
+          instance_id =
+            parsed.delete(:instance_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["agent_gateways/%1$s/keys/%2$s", instance_id, key_id],
+            model: Telnyx::AgentGateways::AgentGatewayKeyResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @tool_permissions = Telnyx::Resources::AgentGateways::Keys::ToolPermissions.new(client: client)
+        end
+      end
+    end
+  end
+end