Claude Platform Docs

归档隧道

Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/archive

已弃用。 此 Admin API 端点已被 Claude API 上的 /v1/tunnels 取代,并将在迁移窗口期后移除。新集成应使用 /v1/tunnels,并附带 anthropic-beta: mcp-tunnels-2026-06-22 标头和携带 workspace:manage_tunnels 范围的 WIF 令牌。在迁移窗口期内,现有集成可继续使用 mcp-tunnels-2026-05-19 标头和 org:manage_tunnels 范围。

归档隧道。归档不可逆。

隧道上每个未归档的证书都会在同一操作中被归档,主机名将被停用且永不重新分配,隧道令牌将失效。对已归档的隧道重试会原样返回现有记录。

Path parameters
tunnel_id: string

ID of the Tunnel.

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

Required for all Tunnel endpoints.

Returns
id: string

ID of the Tunnel.

archived_at: string or null

RFC 3339 datetime string indicating when the Tunnel was archived, or null if it is not archived.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the Tunnel was created.

formatdate-time
display_name: string or null

Human-readable name for the Tunnel (1–255 characters), or null if unset.

domain: string

Anthropic-assigned hostname for the Tunnel. MCP server URLs whose host is a subdomain of this value are routed through the Tunnel. Globally unique and never reused, even after the Tunnel is archived.

type: "tunnel"

Object type. Always tunnel for Tunnels.

defaulttunnel
workspace_id: string or null

ID of the Workspace this Tunnel belongs to, or null for the default Workspace. Immutable after creation.

归档隧道
cURL
curl https://api.anthropic.com/v1/organizations/tunnels/$TUNNEL_ID/archive \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
Returns Examples
Response 200
{
  "id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
  "archived_at": "2024-11-01T23:59:27.427722Z",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "Production",
  "domain": "a1b2c3d4.tunnel.anthropic.com",
  "type": "tunnel",
  "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
}