Effectuer la rotation du jeton d'un tunnel

$ ant beta:tunnels rotate-token

POST/v1/tunnels/{tunnel_id}/rotate_token

L'API Tunnels est en « research preview » (aperçu de recherche). Elle nécessite l'en-tête anthropic-beta: mcp-tunnels-2026-06-22 et peut changer sans période de dépréciation. Elle remplace les points de terminaison de l'Admin API situés sous /v1/organizations/tunnels, qui restent disponibles pendant une fenêtre de migration.

Effectue la rotation du jeton de connecteur d'un tunnel. La rotation invalide le jeton actuel pour les nouvelles connexions et renvoie une nouvelle valeur ; les connexions établies ne sont pas interrompues. Un connecteur redémarré après la rotation doit utiliser la nouvelle valeur.

Parameters

--tunnel-id: string⁠Path

ID of the tunnel (tnl_...).

--reason: optional string

Optional free-text reason for the rotation, recorded for audit.

maxLength1024

--beta: optional array of AnthropicBeta⁠Header

This endpoint is in beta: requests must send mcp-tunnels-2026-06-22 in this header.

--workspace-id: optional string⁠Header

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

beta_tunnel_token: object{ type: "tunnel_token", id, tunnel_token }

A tunnel's connector token.

type: "tunnel_token"

id: string

Stable identifier for the current token value. Changes when the token is rotated.

tunnel_token: string

The connector token used to run the tunnel. Treat as a credential.

Effectuer la rotation du jeton d'un tunnel

ant beta:tunnels rotate-token \
  --api-key my-anthropic-api-key \
  --tunnel-id tunnel_id

Response 200

{
  "id": "id",
  "tunnel_token": "tunnel_token",
  "type": "tunnel_token"
}

Returns Examples

Response 200

{
  "id": "id",
  "tunnel_token": "tunnel_token",
  "type": "tunnel_token"
}