Tunnel-Token rotieren

Deprecated

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

Abgekündigt. Dieser Admin API-Endpunkt wird durch /v1/tunnels in der Claude API ersetzt und nach einem Migrationszeitraum entfernt. Neue Integrationen sollten /v1/tunnels mit dem Header anthropic-beta: mcp-tunnels-2026-06-22 und einem WIF-Token mit dem Scope workspace:manage_tunnels verwenden. Bestehende Integrationen funktionieren während des Migrationszeitraums weiterhin mit dem Header mcp-tunnels-2026-05-19 und dem Scope org:manage_tunnels.

Macht das aktuelle Token des Tunnels für neue Verbindungen ungültig und gibt einen neuen Wert zurück.

Bestehende Verbindungen werden durch die Rotation nicht getrennt; ein Konnektor, der nach der Rotation neu gestartet wird, muss den neuen Wert verwenden. Ein optionaler reason wird als betrieblicher Kontext erfasst.

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

Tunnel-Token rotieren

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"
}