telnyx 5.174.0 → 5.175.0

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

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # MCP servers on an instance, served to agents at one MCP endpoint.
+      class McpServers
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::McpServerCreateParams} for more details.
+        #
+        # Adds an MCP server. The instance serves its tools at `{gateway_url}/mcp`, each
+        # named with the server's `name` and a hyphen, to the keys granted the server and,
+        # with `open_to_every_key`, to every key. The instance must be `ready`; otherwise
+        # the request answers `409`.
+        #
+        # @overload create(instance_id, name:, url:, auth: nil, forwarded_headers: nil, open_to_every_key: nil, static_headers: nil, tools: nil, transport: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param name [String] A name for the server, unique on the instance across MCP servers and APIs, regar
+        #
+        # @param url [String] The server's MCP endpoint, `http` or `https`.
+        #
+        # @param auth [Telnyx::Models::AgentGateways::AgentGatewayNoAuth, Telnyx::Models::AgentGateways::AgentGatewayStaticAuth, Telnyx::Models::AgentGateways::AgentGatewayOAuthClientCredentials, Telnyx::Models::AgentGateways::AgentGatewayPassthroughAuth, Telnyx::Models::AgentGateways::AgentGatewayAwsSigV4Auth] How the gateway authenticates to the server. Replaced whole on an update; `{"typ
+        #
+        # @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 tools the server exposes to every key, by name. `[]` exposes every tool.
+        #
+        # @param transport [Symbol, Telnyx::Models::AgentGateways::McpServerCreateParams::Transport] `http` for Streamable HTTP, or `sse` for Server-Sent Events.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayMcpServerResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::McpServerCreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::McpServerCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/mcp_servers", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayMcpServerResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::McpServerUpdateParams} for more details.
+        #
+        # Changes an MCP server's settings. A field left out stays as it is. `auth` is
+        # replaced whole, `tools: []` exposes every tool, and `static_headers: {}` clears
+        # the headers. The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload update(server_id, instance_id:, auth: nil, forwarded_headers: nil, name: nil, open_to_every_key: nil, static_headers: nil, tools: nil, transport: nil, url: nil, request_options: {})
+        #
+        # @param server_id [String] Path param: The MCP server'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, Telnyx::Models::AgentGateways::AgentGatewayAwsSigV4Auth] Body param: How the gateway authenticates to the server. Replaced whole on an up
+        #
+        # @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 server, unique on the instance across MCP servers and
+        #
+        # @param open_to_every_key [Boolean] Body param: `true` lets every key on the instance use the server, granted or not
+        #
+        # @param static_headers [Hash{Symbol=>String}] Body param: Headers sent on every request.
+        #
+        # @param tools [Array<String>] Body param: The tools the server exposes to every key, by name. `[]` exposes eve
+        #
+        # @param transport [Symbol, Telnyx::Models::AgentGateways::McpServerUpdateParams::Transport] Body param: `http` for Streamable HTTP, or `sse` for Server-Sent Events.
+        #
+        # @param url [String] Body param: The server's MCP endpoint, `http` or `https`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayMcpServerResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::McpServerUpdateParams
+        def update(server_id, params)
+          parsed, options = Telnyx::AgentGateways::McpServerUpdateParams.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/mcp_servers/%2$s", instance_id, server_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayMcpServerResponse,
+            options: options
+          )
+        end
+
+        # Lists the MCP servers the instance serves at `{gateway_url}/mcp`, 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::McpServerListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::McpServerListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/mcp_servers", instance_id],
+            model: Telnyx::Models::AgentGateways::McpServerListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Removes an MCP server and returns it as it was. Its `id` stays in the tool
+        # permissions that name it until they are next set. The instance must be `ready`;
+        # otherwise the request answers `409`.
+        #
+        # @overload delete(server_id, instance_id:, request_options: {})
+        #
+        # @param server_id [String] The MCP server's `id`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayMcpServerResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::McpServerDeleteParams
+        def delete(server_id, params)
+          parsed, options = Telnyx::AgentGateways::McpServerDeleteParams.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/mcp_servers/%2$s", instance_id, server_id],
+            model: Telnyx::AgentGateways::AgentGatewayMcpServerResponse,
+            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/policies.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Named sets of guardrails an instance applies to requests.
+      class Policies
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::PolicyCreateParams} for more details.
+        #
+        # Creates a named set of guardrails. It applies from the next request on, to the
+        # requests that name it in `policies` and to those its
+        # [attachments](https://developers.telnyx.com/api-reference/agent-gateway-policy-attachments/attach-a-policy)
+        # match.
+        #
+        # @overload create(instance_id, name:, base: nil, description: nil, guardrails: nil, model: nil, pipeline: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param name [String] A name, unique on the instance. A request names the policy in its `policies` fie
+        #
+        # @param base [String, nil] A policy this one builds on, by name. The policy starts with the base's guardrai
+        #
+        # @param description [String, nil] What the policy is for.
+        #
+        # @param guardrails [Telnyx::Models::AgentGateways::AgentGatewayPolicyGuardrails] The guardrails a policy adds to its base's, and the ones it removes from them, b
+        #
+        # @param model [String, nil] A condition on the model, by name or regular expression. The policy's guardrails
+        #
+        # @param pipeline [Telnyx::Models::AgentGateways::AgentGatewayPolicyPipeline, nil] Ordered steps that run in place of the policy's guardrails running independently
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyCreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::PolicyCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/policies", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayPolicyResponse,
+            options: options
+          )
+        end
+
+        # Returns one policy, in its current version.
+        #
+        # @overload retrieve(name, instance_id:, request_options: {})
+        #
+        # @param name [String] The policy's `name`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyRetrieveParams
+        def retrieve(name, params)
+          parsed, options = Telnyx::AgentGateways::PolicyRetrieveParams.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/policies/%2$s", instance_id, name],
+            model: Telnyx::AgentGateways::AgentGatewayPolicyResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::PolicyUpdateParams} for more details.
+        #
+        # Changes a policy, which publishes a new version of it. A field left out stays as
+        # it is; `guardrails` and `pipeline` are replaced whole, and `model: null` removes
+        # the condition.
+        #
+        # @overload update(name, instance_id:, base: nil, description: nil, guardrails: nil, model: nil, pipeline: nil, request_options: {})
+        #
+        # @param name [String] Path param: The policy's `name`.
+        #
+        # @param instance_id [String] Path param: The Agent Gateway's `id`.
+        #
+        # @param base [String, nil] Body param: A policy this one builds on, by name. The policy starts with the bas
+        #
+        # @param description [String, nil] Body param: What the policy is for.
+        #
+        # @param guardrails [Telnyx::Models::AgentGateways::AgentGatewayPolicyGuardrails] Body param: The guardrails a policy adds to its base's, and the ones it removes
+        #
+        # @param model [String, nil] Body param: A condition on the model, by name or regular expression. The policy'
+        #
+        # @param pipeline [Telnyx::Models::AgentGateways::AgentGatewayPolicyPipeline, nil] Body param: Ordered steps that run in place of the policy's guardrails running i
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyUpdateParams
+        def update(name, params)
+          parsed, options = Telnyx::AgentGateways::PolicyUpdateParams.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/policies/%2$s", instance_id, name],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayPolicyResponse,
+            options: options
+          )
+        end
+
+        # Lists the instance's policies, each in its current version.
+        #
+        # @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::PolicyListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/policies", instance_id],
+            model: Telnyx::Models::AgentGateways::PolicyListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Deletes a policy and every version of it, and returns it as it was. A policy
+        # that an attachment names, or that another policy builds on, cannot be deleted.
+        #
+        # @overload delete(name, instance_id:, request_options: {})
+        #
+        # @param name [String] The policy's `name`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyDeleteParams
+        def delete(name, params)
+          parsed, options = Telnyx::AgentGateways::PolicyDeleteParams.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/policies/%2$s", instance_id, name],
+            model: Telnyx::AgentGateways::AgentGatewayPolicyResponse,
+            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/policy_attachments.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Where an instance applies each policy.
+      class PolicyAttachments
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::PolicyAttachmentCreateParams} for more details.
+        #
+        # Applies a policy to every request, or to the requests for the models named. It
+        # applies from the next request on.
+        #
+        # @overload create(instance_id, policy:, default: nil, models: nil, priority: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param policy [String] The policy to apply, by name.
+        #
+        # @param default [Boolean] `true` applies the policy only to the requests no other attachment matches.
+        #
+        # @param models [Array<String>] The models whose requests the policy applies to, by name. A name can use `*` as
+        #
+        # @param priority [Integer, nil] An attachment with a priority applies before the others.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyAttachmentResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyAttachmentCreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::PolicyAttachmentCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/policy_attachments", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayPolicyAttachmentResponse,
+            options: options
+          )
+        end
+
+        # Lists where the instance applies each policy.
+        #
+        # @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::PolicyAttachmentListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyAttachmentListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/policy_attachments", instance_id],
+            model: Telnyx::Models::AgentGateways::PolicyAttachmentListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Removes an attachment and returns it as it was. The policy stays.
+        #
+        # @overload delete(attachment_id, instance_id:, request_options: {})
+        #
+        # @param attachment_id [String] The attachment's `id`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayPolicyAttachmentResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::PolicyAttachmentDeleteParams
+        def delete(attachment_id, params)
+          parsed, options = Telnyx::AgentGateways::PolicyAttachmentDeleteParams.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/policy_attachments/%2$s", instance_id, attachment_id],
+            model: Telnyx::AgentGateways::AgentGatewayPolicyAttachmentResponse,
+            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/teams/tool_permissions.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      class Teams
+        # The MCP servers and tools a key or team may use.
+        class ToolPermissions
+          # 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(team_id, instance_id:, servers:, request_options: {})
+          #
+          # @param team_id [String] Path param: The team's `id`.
+          #
+          # @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::Teams::ToolPermissionCreateParams
+          def create(team_id, params)
+            parsed, options = Telnyx::AgentGateways::Teams::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/teams/%2$s/tool_permissions", instance_id, team_id],
+              body: parsed,
+              model: Telnyx::AgentGateways::Keys::AgentGatewayToolPermissionsResponse,
+              options: options
+            )
+          end
+
+          # Returns the MCP servers and APIs the team's keys may use, and the tools within
+          # each. `servers: []` means none. The instance must be `ready`; otherwise the
+          # request answers `409`.
+          #
+          # @overload list(team_id, instance_id:, request_options: {})
+          #
+          # @param team_id [String] The team's `id`.
+          #
+          # @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::Teams::ToolPermissionListParams
+          def list(team_id, params)
+            parsed, options = Telnyx::AgentGateways::Teams::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/teams/%2$s/tool_permissions", instance_id, team_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/teams.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Teams on an instance: shared model lists, budgets, and rate limits.
+      class Teams
+        # The MCP servers and tools a key or team may use.
+        # @return [Telnyx::Resources::AgentGateways::Teams::ToolPermissions]
+        attr_reader :tool_permissions
+
+        # Creates a team on the instance. A team is a model list, a budget, and rate
+        # limits that its keys share. Names need not be unique; the `id` identifies the
+        # team. The instance must be `ready`; otherwise the request answers `409`.
+        #
+        # @overload create(instance_id, name:, budget_resets_every: nil, max_budget: nil, models: nil, requests_per_minute: nil, tokens_per_minute: nil, request_options: {})
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param name [String] A label for people.
+        #
+        # @param budget_resets_every [String, nil] How often the spend resets: a number and a unit, `s`, `m`, `h`, or `d`.
+        #
+        # @param max_budget [Float, nil] The most the team's keys may spend together, in USD.
+        #
+        # @param models [Array<String>, nil] The models the team's keys may use. Leave it out to allow every model.
+        #
+        # @param requests_per_minute [Integer, nil] The most requests the team's keys may make per minute, together.
+        #
+        # @param tokens_per_minute [Integer, nil] The most tokens the team's keys may use per minute, together.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayTeamResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::TeamCreateParams
+        def create(instance_id, params)
+          parsed, options = Telnyx::AgentGateways::TeamCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["agent_gateways/%1$s/teams", instance_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayTeamResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AgentGateways::TeamUpdateParams} for more details.
+        #
+        # Changes a team's settings. A field left out stays as it is, and `null` clears
+        # it. `models: []` lifts the model restriction. Setting `blocked` to `true` makes
+        # the instance refuse every key in the team with `401`. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        #
+        # @overload update(team_id, instance_id:, blocked: nil, budget_resets_every: nil, max_budget: nil, models: nil, name: nil, requests_per_minute: nil, tokens_per_minute: nil, request_options: {})
+        #
+        # @param team_id [String] Path param: The team's `id`.
+        #
+        # @param instance_id [String] Path param: The Agent Gateway's `id`.
+        #
+        # @param blocked [Boolean] Body param: `true` makes the instance refuse every key in the team; `false` lets
+        #
+        # @param budget_resets_every [String, nil] Body param: How often the spend resets.
+        #
+        # @param max_budget [Float, nil] Body param: The most the team's keys may spend together, in USD.
+        #
+        # @param models [Array<String>] Body param: The models the team's keys 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 team's keys may make per minute, together.
+        #
+        # @param tokens_per_minute [Integer, nil] Body param: The most tokens the team's keys may use per minute, together.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayTeamResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::TeamUpdateParams
+        def update(team_id, params)
+          parsed, options = Telnyx::AgentGateways::TeamUpdateParams.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/teams/%2$s", instance_id, team_id],
+            body: parsed,
+            model: Telnyx::AgentGateways::AgentGatewayTeamResponse,
+            options: options
+          )
+        end
+
+        # Lists the instance's teams. 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::TeamListResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::TeamListParams
+        def list(instance_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["agent_gateways/%1$s/teams", instance_id],
+            model: Telnyx::Models::AgentGateways::TeamListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Deletes a team that has no keys and returns it. A team that still has keys
+        # answers `409`; delete or move its keys first. The instance must be `ready`;
+        # otherwise the request answers `409`.
+        #
+        # @overload delete(team_id, instance_id:, request_options: {})
+        #
+        # @param team_id [String] The team's `id`.
+        #
+        # @param instance_id [String] The Agent Gateway's `id`.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AgentGateways::AgentGatewayTeamResponse]
+        #
+        # @see Telnyx::Models::AgentGateways::TeamDeleteParams
+        def delete(team_id, params)
+          parsed, options = Telnyx::AgentGateways::TeamDeleteParams.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/teams/%2$s", instance_id, team_id],
+            model: Telnyx::AgentGateways::AgentGatewayTeamResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @tool_permissions = Telnyx::Resources::AgentGateways::Teams::ToolPermissions.new(client: client)
+        end
+      end
+    end
+  end
+end