Ruota token del tunnel

Deprecated

POST/v1/organizations/tunnels/{tunnel_id}/rotate_token

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Invalida il token corrente del tunnel per le nuove connessioni e restituisce un nuovo valore.

Le connessioni stabilite non vengono interrotte dalla rotazione; un connettore riavviato dopo la rotazione deve usare il nuovo valore. Un reason facoltativo viene registrato per il contesto operativo.

Path parameters

tunnel_id: string

ID of the Tunnel.

Headers

"anthropic-beta": array of "mcp-tunnels-2026-05-19"

Required for all Tunnel endpoints.

Body

reason: optional string or null

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

maxLength1024

Returns

id: string

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

tunnel_token: string

The tunnel's connection token.

type: "tunnel_token"

Object type. Always tunnel_token for Tunnel Tokens.

defaulttunnel_token

Ruota token del tunnel

cURL

curl https://api.anthropic.com/v1/organizations/tunnels/$TUNNEL_ID/rotate_token \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Response 200

{
  "id": "ttkn_bb97000eaec162831399ca9b6684a4fdf5be49ace5683057b017aab5c87e19e0",
  "tunnel_token": "eyJhIjoiRVhBTVBMRSIsInQiOiJFWEFNUExFIiwicyI6IkVYQU1QTEUifQ==",
  "type": "tunnel_token"
}

Returns Examples

Response 200

{
  "id": "ttkn_bb97000eaec162831399ca9b6684a4fdf5be49ace5683057b017aab5c87e19e0",
  "tunnel_token": "eyJhIjoiRVhBTVBMRSIsInQiOiJFWEFNUExFIiwicyI6IkVYQU1QTEUifQ==",
  "type": "tunnel_token"
}