Sign in

List Tunnels

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.

List the organization's tunnels.

Results span the caller's organization, ordered by creation time (newest first). Use workspace_id to filter to a single workspace; archived tunnels are excluded unless include_archived is set.

get/v1/organizations/tunnels?beta=true

Query parameters

pagestring nullable

Opaque pagination cursor from a previous response's next_page. Omit to fetch the first page.

Example:page_MjAyNS0wNS0xNFQwMDowMDowMFo=

Opaque pagination cursor from a previous response's next_page. Omit to fetch the first page.

limitinteger

Maximum number of tunnels to return in a single page.

Maximum number of tunnels to return in a single page.

workspace_idstring nullable

Return only tunnels in this Workspace. Accepts a wrkspc_-prefixed Workspace ID; omit to list tunnels across all Workspaces.

Example:wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Return only tunnels in this Workspace. Accepts a wrkspc_-prefixed Workspace ID; omit to list tunnels across all Workspaces.

include_archivedboolean

Include archived tunnels in the results. Archived tunnels are excluded by default.

Include archived tunnels in the results. Archived tunnels are excluded by default.

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

next_pagestring nullable required

Opaque cursor for the next page, or null if there are no more results.

Example response

{
  "data": [
    {
      "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"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Changes