telnyx 5.174.0 → 5.175.0

data/rbi/telnyx/models.rbi

@@ -46,6 +46,26 @@ module Telnyx
   AdvancedOrderUpdateRequirementGroupParams =
     Telnyx::Models::AdvancedOrderUpdateRequirementGroupParams
 
+  AgentGateway = Telnyx::Models::AgentGateway
+
+  AgentGatewayCreateParams = Telnyx::Models::AgentGatewayCreateParams
+
+  AgentGatewayDeleteParams = Telnyx::Models::AgentGatewayDeleteParams
+
+  AgentGatewayListParams = Telnyx::Models::AgentGatewayListParams
+
+  AgentGatewayResponse = Telnyx::Models::AgentGatewayResponse
+
+  AgentGatewayRetrieveModelsParams =
+    Telnyx::Models::AgentGatewayRetrieveModelsParams
+
+  AgentGatewayRetrieveParams = Telnyx::Models::AgentGatewayRetrieveParams
+
+  AgentGatewayRetrieveSpendLogsParams =
+    Telnyx::Models::AgentGatewayRetrieveSpendLogsParams
+
+  AgentGateways = Telnyx::Models::AgentGateways
+
   AI = Telnyx::Models::AI
 
   AIRetrieveConversationHistoriesParams =
@@ -173,6 +193,26 @@ module Telnyx
 
   BundlePricing = Telnyx::Models::BundlePricing
 
+  CalendarConnection = Telnyx::Models::CalendarConnection
+
+  CalendarConnectionCreateParams =
+    Telnyx::Models::CalendarConnectionCreateParams
+
+  CalendarConnectionDeleteParams =
+    Telnyx::Models::CalendarConnectionDeleteParams
+
+  CalendarConnectionListParams = Telnyx::Models::CalendarConnectionListParams
+
+  CalendarConnectionResponse = Telnyx::Models::CalendarConnectionResponse
+
+  CalendarConnectionRetrieveParams =
+    Telnyx::Models::CalendarConnectionRetrieveParams
+
+  CalendarConnections = Telnyx::Models::CalendarConnections
+
+  CalendarConnectionUpdateParams =
+    Telnyx::Models::CalendarConnectionUpdateParams
+
   CallAIGatherEnded = Telnyx::Models::CallAIGatherEnded
 
   CallAIGatherEndedWebhookEvent = Telnyx::Models::CallAIGatherEndedWebhookEvent
@@ -1218,8 +1258,12 @@ module Telnyx
 
   MediaUploadParams = Telnyx::Models::MediaUploadParams
 
+  MeetingBot = Telnyx::Models::MeetingBot
+
   MeetingSession = Telnyx::Models::MeetingSession
 
+  MeetingSessionAssistant = Telnyx::Models::MeetingSessionAssistant
+
   MeetingSessionCreateParams = Telnyx::Models::MeetingSessionCreateParams
 
   MeetingSessionDeleteParams = Telnyx::Models::MeetingSessionDeleteParams
@@ -1227,8 +1271,15 @@ module Telnyx
   MeetingSessionDeleteRecordingMediaParams =
     Telnyx::Models::MeetingSessionDeleteRecordingMediaParams
 
+  MeetingSessionLeavePolicy = Telnyx::Models::MeetingSessionLeavePolicy
+
   MeetingSessionListParams = Telnyx::Models::MeetingSessionListParams
 
+  MeetingSessionRecordingDestination =
+    Telnyx::Models::MeetingSessionRecordingDestination
+
+  MeetingSessionRecordingExport = Telnyx::Models::MeetingSessionRecordingExport
+
   MeetingSessionResponse = Telnyx::Models::MeetingSessionResponse
 
   MeetingSessionRetrieveEventsParams =
@@ -1236,6 +1287,9 @@ module Telnyx
 
   MeetingSessionRetrieveParams = Telnyx::Models::MeetingSessionRetrieveParams
 
+  MeetingSessionRetrieveRecordingsParams =
+    Telnyx::Models::MeetingSessionRetrieveRecordingsParams
+
   MeetingSessionRetrieveTranscriptParams =
     Telnyx::Models::MeetingSessionRetrieveTranscriptParams
 
@@ -1910,6 +1964,11 @@ module Telnyx
 
   RecordingDeleteParams = Telnyx::Models::RecordingDeleteParams
 
+  RecordingExportedWebhookEvent = Telnyx::Models::RecordingExportedWebhookEvent
+
+  RecordingExportFailedWebhookEvent =
+    Telnyx::Models::RecordingExportFailedWebhookEvent
+
   RecordingListParams = Telnyx::Models::RecordingListParams
 
   RecordingResponse = Telnyx::Models::RecordingResponse
@@ -2248,6 +2307,9 @@ module Telnyx
   TelephonyCredentialRetrieveParams =
     Telnyx::Models::TelephonyCredentialRetrieveParams
 
+  TelephonyCredentialRetrieveTokenMaterialParams =
+    Telnyx::Models::TelephonyCredentialRetrieveTokenMaterialParams
+
   TelephonyCredentialUpdateParams =
     Telnyx::Models::TelephonyCredentialUpdateParams
 
@@ -2288,6 +2350,8 @@ module Telnyx
 
   TimeRange = Telnyx::Models::TimeRange
 
+  TokenMaterial = Telnyx::Models::TokenMaterial
+
   TrackingSettings = Telnyx::Models::TrackingSettings
 
   TrafficPolicyProfile = Telnyx::Models::TrafficPolicyProfile
@@ -2392,6 +2456,12 @@ module Telnyx
 
   UserAddressRetrieveParams = Telnyx::Models::UserAddressRetrieveParams
 
+  UserProfileAPI = Telnyx::Models::UserProfileAPI
+
+  UserProfileListParams = Telnyx::Models::UserProfileListParams
+
+  UserProfilePatchAllParams = Telnyx::Models::UserProfilePatchAllParams
+
   UserRequirement = Telnyx::Models::UserRequirement
 
   UserTagListParams = Telnyx::Models::UserTagListParams

data/rbi/telnyx/resources/agent_gateways/apis.rbi

@@ -0,0 +1,157 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # REST APIs on an instance, served to agents as tools.
+      class APIs
+        # 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`.
+        sig do
+          params(
+            instance_id: String,
+            name: String,
+            spec_url: String,
+            auth:
+              T.any(
+                Telnyx::AgentGateways::AgentGatewayNoAuth::OrHash,
+                Telnyx::AgentGateways::AgentGatewayStaticAuth::OrHash,
+                Telnyx::AgentGateways::AgentGatewayOAuthClientCredentials::OrHash,
+                Telnyx::AgentGateways::AgentGatewayPassthroughAuth::OrHash
+              ),
+            base_url: T.nilable(String),
+            forwarded_headers: T::Array[String],
+            open_to_every_key: T::Boolean,
+            static_headers: T::Hash[Symbol, String],
+            tools: T::Array[String],
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayAPIResponse)
+        end
+        def create(
+          # The Agent Gateway's `id`.
+          instance_id,
+          # 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.
+          name:,
+          # The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1, or Swagger
+          # 2.0.
+          spec_url:,
+          # How the gateway authenticates to the API. AWS Signature Version 4 is for MCP
+          # servers only. Replaced whole on an update.
+          auth: nil,
+          # Where the gateway sends the API's requests. Without it, the gateway takes the
+          # description's first `servers` entry.
+          base_url: nil,
+          # Headers copied from the agent's request, by name.
+          forwarded_headers: nil,
+          # `true` lets every key on the instance use the server, granted or not.
+          open_to_every_key: nil,
+          # Headers sent on every request.
+          static_headers: nil,
+          # The operations the API exposes as tools, by tool name. `[]` exposes every
+          # operation.
+          tools: nil,
+          request_options: {}
+        )
+        end
+
+        # 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`.
+        sig do
+          params(
+            api_id: String,
+            instance_id: String,
+            auth:
+              T.any(
+                Telnyx::AgentGateways::AgentGatewayNoAuth::OrHash,
+                Telnyx::AgentGateways::AgentGatewayStaticAuth::OrHash,
+                Telnyx::AgentGateways::AgentGatewayOAuthClientCredentials::OrHash,
+                Telnyx::AgentGateways::AgentGatewayPassthroughAuth::OrHash
+              ),
+            base_url: T.nilable(String),
+            forwarded_headers: T::Array[String],
+            name: String,
+            open_to_every_key: T::Boolean,
+            spec_url: String,
+            static_headers: T::Hash[Symbol, String],
+            tools: T::Array[String],
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayAPIResponse)
+        end
+        def update(
+          # Path param: The API's `id`.
+          api_id,
+          # Path param: The Agent Gateway's `id`.
+          instance_id:,
+          # Body param: How the gateway authenticates to the API. AWS Signature Version 4 is
+          # for MCP servers only. Replaced whole on an update.
+          auth: nil,
+          # Body param: Where the gateway sends the API's requests. Without it, the gateway
+          # takes the description's first `servers` entry.
+          base_url: nil,
+          # Body param: Headers copied from the agent's request, by name.
+          forwarded_headers: nil,
+          # Body param: 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.
+          name: nil,
+          # Body param: `true` lets every key on the instance use the server, granted or
+          # not.
+          open_to_every_key: nil,
+          # Body param: The URL of the API's OpenAPI description: OpenAPI 3.0, OpenAPI 3.1,
+          # or Swagger 2.0.
+          spec_url: nil,
+          # Body param: Headers sent on every request.
+          static_headers: nil,
+          # Body param: The operations the API exposes as tools, by tool name. `[]` exposes
+          # every operation.
+          tools: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists the REST APIs the instance serves as tools, without their credentials. The
+        # instance must be `ready`; otherwise the request answers `409`.
+        sig do
+          params(
+            instance_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::AgentGateways::APIListResponse)
+        end
+        def list(
+          # The Agent Gateway's `id`.
+          instance_id,
+          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`.
+        sig do
+          params(
+            api_id: String,
+            instance_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayAPIResponse)
+        end
+        def delete(
+          # The API's `id`.
+          api_id,
+          # The Agent Gateway's `id`.
+          instance_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/agent_gateways/guardrails.rbi

@@ -0,0 +1,144 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Checks an instance runs on model and tool requests.
+      class Guardrails
+        # 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`.
+        sig do
+          params(
+            instance_id: String,
+            modes:
+              T::Array[
+                Telnyx::AgentGateways::GuardrailCreateParams::Mode::OrSymbol
+              ],
+            name: String,
+            type: Telnyx::AgentGateways::GuardrailCreateParams::Type::OrSymbol,
+            always_on: T::Boolean,
+            settings: T::Hash[Symbol, T.anything],
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayGuardrailResponse)
+        end
+        def create(
+          # The Agent Gateway's `id`.
+          instance_id,
+          # When the guardrail runs. Each type runs in some modes only.
+          modes:,
+          # A name, unique on the instance. A request names it in its `guardrails` field.
+          name:,
+          # The kind of check. It cannot change after create.
+          type:,
+          # `true` runs the guardrail on every request, and a request cannot turn it off.
+          # `false` runs it on the requests that name it.
+          always_on: nil,
+          # The type's settings. `content_filter`: `patterns` (prebuilt patterns by `name`,
+          # such as `us_ssn` or `email`), `regexes` (each a `name`, which tags masked
+          # matches, and a `pattern`), `keywords` (each a `keyword`), and `categories` (each
+          # a `name`), each entry with an `action` of `block` or `mask`. `tool_permission`:
+          # `rules` (`id`, `tool_name`, `tool_type`, `decision`, `argument_patterns`), a
+          # `default` decision, and `on_denied` (`block` or `rewrite`). `model_judge`: a
+          # `model` on the instance and weighted `criteria` (`name`, `description`,
+          # `weight`, the weights summing to 100). `custom_code`: `code` defining
+          # `apply_guardrail(inputs, request_data, input_type)`. `lakera`: `api_key`,
+          # `project_id`, `api_base`. `presidio`: `analyzer_url`, `anonymizer_url`,
+          # `entities` (entity name to `block` or `mask`), `language`. `bedrock`:
+          # `guardrail_id`, `version`, `region`, and `access_key_id` with
+          # `secret_access_key`, or `role_name`. `azure_content_safety`: `api_key`,
+          # `endpoint`, `severity` (0 to 7). Provider secrets are write-only.
+          settings: nil,
+          request_options: {}
+        )
+        end
+
+        # 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`.
+        sig do
+          params(
+            guardrail_id: String,
+            instance_id: String,
+            always_on: T::Boolean,
+            modes:
+              T::Array[
+                Telnyx::AgentGateways::GuardrailUpdateParams::Mode::OrSymbol
+              ],
+            name: String,
+            settings: T::Hash[Symbol, T.anything],
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayGuardrailResponse)
+        end
+        def update(
+          # Path param: The guardrail's `id`.
+          guardrail_id,
+          # Path param: The Agent Gateway's `id`.
+          instance_id:,
+          # Body param: `true` runs the guardrail on every request, and a request cannot
+          # turn it off. `false` runs it on the requests that name it.
+          always_on: nil,
+          # Body param: When the guardrail runs. Each type runs in some modes only.
+          modes: nil,
+          # Body param: A name, unique on the instance. A request names it in its
+          # `guardrails` field.
+          name: nil,
+          # Body param: The type's settings. `content_filter`: `patterns` (prebuilt patterns
+          # by name, such as `us_ssn` or `email`), `regexes`, `keywords`, and `categories`
+          # (such as `prompt_injection`), each with an `action` of `block` or `mask`.
+          # `tool_permission`: `rules` (`id`, `tool_name`, `tool_type`, `decision`,
+          # `argument_patterns`), a `default` decision, and `on_denied` (`block` or
+          # `rewrite`). `model_judge`: a `model` on the instance and weighted `criteria`
+          # (`name`, `description`, `weight`, the weights summing to 100). `custom_code`:
+          # `code` defining `apply_guardrail(inputs, request_data, input_type)`. `lakera`:
+          # `api_key`, `project_id`, `api_base`. `presidio`: `analyzer_url`,
+          # `anonymizer_url`, `entities` (entity name to `block` or `mask`), `language`.
+          # `bedrock`: `guardrail_id`, `version`, `region`, and `access_key_id` with
+          # `secret_access_key`, or `role_name`. `azure_content_safety`: `api_key`,
+          # `endpoint`, `severity` (0 to 7). Provider secrets are write-only.
+          settings: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists the instance's guardrails, without their secrets. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        sig do
+          params(
+            instance_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::AgentGateways::GuardrailListResponse)
+        end
+        def list(
+          # The Agent Gateway's `id`.
+          instance_id,
+          request_options: {}
+        )
+        end
+
+        # Removes a guardrail and returns it as it was. The instance must be `ready`;
+        # otherwise the request answers `409`.
+        sig do
+          params(
+            guardrail_id: String,
+            instance_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayGuardrailResponse)
+        end
+        def delete(
+          # The guardrail's `id`.
+          guardrail_id,
+          # The Agent Gateway's `id`.
+          instance_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/agent_gateways/keys/tool_permissions.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      class Keys
+        # 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`.
+          sig do
+            params(
+              key_id: String,
+              instance_id: String,
+              servers:
+                T::Array[
+                  Telnyx::AgentGateways::Keys::AgentGatewayToolPermissions::Server::OrHash
+                ],
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::AgentGateways::Keys::AgentGatewayToolPermissionsResponse
+            )
+          end
+          def create(
+            # Path param: The key's `id`, a 64-character hash the instance stores in place of
+            # the key.
+            key_id,
+            # Path param: The Agent Gateway's `id`.
+            instance_id:,
+            # Body param: The servers granted, each with its tools. `[]` grants none.
+            servers:,
+            request_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`.
+          sig do
+            params(
+              key_id: String,
+              instance_id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::AgentGateways::Keys::AgentGatewayToolPermissionsResponse
+            )
+          end
+          def list(
+            # The key's `id`, a 64-character hash the instance stores in place of the key.
+            key_id,
+            # The Agent Gateway's `id`.
+            instance_id:,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/agent_gateways/keys.rbi

@@ -0,0 +1,153 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AgentGateways
+      # Keys on an instance.
+      class Keys
+        # The MCP servers and tools a key or team may use.
+        sig { returns(Telnyx::Resources::AgentGateways::Keys::ToolPermissions) }
+        attr_reader :tool_permissions
+
+        # 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`.
+        sig do
+          params(
+            instance_id: String,
+            budget_resets_every: T.nilable(String),
+            expires_in: T.nilable(String),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            models: T.nilable(T::Array[String]),
+            name: T.nilable(String),
+            requests_per_minute: T.nilable(Integer),
+            team_id: T.nilable(String),
+            tokens_per_minute: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::AgentGateways::KeyCreateResponse)
+        end
+        def create(
+          # The Agent Gateway's `id`.
+          instance_id,
+          # How often the spend resets: a number and a unit, `s`, `m`, `h`, or `d`.
+          budget_resets_every: nil,
+          # How long until the key stops working: a number and a unit, `s`, `m`, `h`, or
+          # `d`.
+          expires_in: nil,
+          # The most the key may spend, in USD.
+          max_budget: nil,
+          # The most requests the key may have in flight at once.
+          max_parallel_requests: nil,
+          # The models the key may use. Leave it out to allow every model.
+          models: nil,
+          # A label for people, unique on the instance.
+          name: nil,
+          # The most requests the key may make per minute.
+          requests_per_minute: nil,
+          # A team on the instance. The key shares the team's model list, budget, and rate
+          # limits.
+          team_id: nil,
+          # The most tokens the key may use per minute.
+          tokens_per_minute: nil,
+          request_options: {}
+        )
+        end
+
+        # 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`.
+        sig do
+          params(
+            key_id: String,
+            instance_id: String,
+            blocked: T::Boolean,
+            budget_resets_every: T.nilable(String),
+            expires_in: T.nilable(String),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            models: T::Array[String],
+            name: String,
+            requests_per_minute: T.nilable(Integer),
+            team_id: T.nilable(String),
+            tokens_per_minute: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayKeyResponse)
+        end
+        def update(
+          # Path param: The key's `id`, a 64-character hash the instance stores in place of
+          # the key.
+          key_id,
+          # Path param: The Agent Gateway's `id`.
+          instance_id:,
+          # Body param: `true` makes the instance refuse the key; `false` lets it through
+          # again.
+          blocked: nil,
+          # Body param: How often the spend resets.
+          budget_resets_every: nil,
+          # Body param: How long from now until the key stops working.
+          expires_in: nil,
+          # Body param: The most the key may spend, in USD.
+          max_budget: nil,
+          # Body param: The most requests the key may have in flight at once.
+          max_parallel_requests: nil,
+          # Body param: The models the key may use. `[]` allows every model.
+          models: nil,
+          # Body param: A label for people.
+          name: nil,
+          # Body param: The most requests the key may make per minute.
+          requests_per_minute: nil,
+          # Body param: Move the key to this team, or `null` to leave its team.
+          team_id: nil,
+          # Body param: The most tokens the key may use per minute.
+          tokens_per_minute: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists the instance's keys, without their values. Returns the first 100. The
+        # instance must be `ready`; otherwise the request answers `409`.
+        sig do
+          params(
+            instance_id: String,
+            team_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::AgentGateways::KeyListResponse)
+        end
+        def list(
+          # The Agent Gateway's `id`.
+          instance_id,
+          # Only the keys of this team.
+          team_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Revokes a key and returns it as it was, without its value. The instance must be
+        # `ready`; otherwise the request answers `409`.
+        sig do
+          params(
+            key_id: String,
+            instance_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::AgentGateways::AgentGatewayKeyResponse)
+        end
+        def delete(
+          # The key's `id`, a 64-character hash the instance stores in place of the key.
+          key_id,
+          # The Agent Gateway's `id`.
+          instance_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end