Sign in

Archive Tunnel

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

Archive 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.

post/v1/organizations/tunnels/{tunnel_id}/archive?beta=true

Path parameters

tunnel_idstring required

ID of the Tunnel.

ID of the Tunnel.

Headers

anthropic-betastring required

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

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

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

archived_atstring date-time nullable required

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

created_atstring date-time required

RFC 3339 datetime string indicating when the Tunnel was created.

display_namestring nullable required

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

domainstring required

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.

idstring required

ID of the Tunnel.

type'tunnel' required

Object type. Always tunnel for Tunnels.

workspace_idstring nullable required

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

Example response

{
  "archived_at": "2024-11-01T23:59:27.427722Z",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "Production",
  "domain": "a1b2c3d4.tunnel.anthropic.com",
  "id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
  "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
}

Changes