One change

List Tunnels

api/admin/mcp_tunnels/list

25 Aug 2026 03:37 UTC first seen 14 Aug 2026 The page's own history The capture it came from

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

api/admin/mcp_tunnels/list Changed · +19 / -16 lines

# List Tunnels ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Tunnels ### Query Parameters ### Header Parameters ### Returns ### Example #### Response

from line 1

----
-title: List Tunnels
-url: https://platform.claude.com/docs/en/api/admin/mcp_tunnels/list
----
+# List Tunnels
 
-## List Tunnels
+**GET** `/v1/organizations/tunnels`
 
-**get** `/v1/organizations/tunnels`
+**Deprecated**
 
 **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`](/docs/en/api/beta/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.

from line 12

 (newest first). Use `workspace_id` to filter to a single workspace;
 archived tunnels are excluded unless `include_archived` is set.
 
-### Query Parameters
+## Query parameters
 
 - `include_archived: optional boolean`

from line 19

   Include archived tunnels in the results. Archived tunnels are excluded by
   default.
 
+  default: false
+
 - `limit: optional number`
 
   Maximum number of tunnels to return in a single page.
 
+  default: 20, maximum: 1000, minimum: 1
+
 - `page: optional string`
 
   Opaque pagination cursor from a previous response's `next_page`. Omit to

from line 37

   Return only tunnels in this Workspace. Accepts a `wrkspc_`-prefixed
   Workspace ID; omit to list tunnels across all Workspaces.
 
-### Header Parameters
+## Headers
 
 - `"anthropic-beta": array of "mcp-tunnels-2026-05-19"`
 
   Required for all Tunnel endpoints.
 
-  - `"mcp-tunnels-2026-05-19"`
+## Returns
 
-### Returns
+- `data: array of object`
 
-- `data: array of object { id, archived_at, created_at, 4 more }`
-
   - `id: string`
 
     ID of the Tunnel.

from line 56

     RFC 3339 datetime string indicating when the Tunnel was archived, or
     `null` if it is not archived.
 
+    format: date-time
+
   - `created_at: string`
 
     RFC 3339 datetime string indicating when the Tunnel was created.
 
+    format: date-time
+
   - `display_name: string or null`
 
     Human-readable name for the Tunnel (1–255 characters), or `null` if unset.

from line 78

 
     Object type. Always `tunnel` for Tunnels.
 
-    - `"tunnel"`
+    default: tunnel
 
   - `workspace_id: string or null`

from line 89

 
   Opaque cursor for the next page, or `null` if there are no more results.
 
-### Example
+## Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/organizations/tunnels \
     -H 'anthropic-version: 2023-06-01' \
     -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {