Sign in

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

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

get/v1/organizations/tunnels/{tunnel_id}?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.

x-api-keystring

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

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