Get Tunnel

get /v1/organizations/tunnels/{tunnel_id}

Retrieve a single tunnel in the caller's organization by ID.

Path Parameters

• tunnel_id: string

  ID of the Tunnel.

Header Parameters

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

  Required for all Tunnel endpoints.

  • "mcp-tunnels-2026-05-19"

Returns

• id: string

  ID of the Tunnel.

• archived_at: string

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

• created_at: string

  RFC 3339 datetime string indicating when the Tunnel was created.

• display_name: string

  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.

  • "tunnel"

• workspace_id: string

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

Example

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

Response

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