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

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared. Required headers: anthropic-beta

Query parameters

pagestring nullable

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

Example:page_MjAyNS0wNS0xNFQwMDowMDowMFo=
limitinteger

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
include_archivedboolean

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

Headers

anthropic-versionstring

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

    • info

      added the enum value admin-user-sign-out-2026-10-08 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta

    • info

      added the enum value experimental-claude-tag-2026-10-21 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta