Archive Tunnel
api/beta/tunnels/archive
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/beta/tunnels/archive Changed · +13 / -16 lines
# Archive Tunnel ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Archive Tunnel ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: Archive Tunnel -url: https://platform.claude.com/docs/en/api/beta/tunnels/archive ---- +# Archive Tunnel -## Archive Tunnel +**POST** `/v1/tunnels/{tunnel_id}/archive` -**post** `/v1/tunnels/{tunnel_id}/archive` - The Tunnels API is in research preview. It requires the `anthropic-beta: mcp-tunnels-2026-06-22` header and may change without a deprecation period. It supersedes the Admin API endpoints at `/v1/organizations/tunnels`, which remain available during a migration window. Archives a tunnel. Archival is irreversible: every non-archived certificate on the tunnel is archived in the same operation, the hostname is retired and never re-allocated, and the tunnel token is invalidated. Retrying against an already-archived tunnel returns the existing record unchanged. -### Path Parameters +## Path parameters - `tunnel_id: string` -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns -- `BetaTunnel object { id, archived_at, created_at, 3 more }` +- `BetaTunnel object` An MCP tunnel.
A timestamp in RFC 3339 format + format: date-time + - `created_at: string` A timestamp in RFC 3339 format + format: date-time + - `display_name: string or null` Human-readable name for the tunnel (1-255 characters). Null if unset.
- `type: "tunnel"` - - `"tunnel"` +## Example -### Example - -```http +```bash curl https://api.anthropic.com/v1/tunnels/$TUNNEL_ID/archive \ -X POST \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {