List Tunnels changedapi/beta/tunnels/list
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.
Recorded here
Lines+14added
Lines−15removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
# List Tunnels ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Tunnels ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Tunnels
3url: https://platform.claude.com/docs/en/api/beta/tunnels/list
4---
1# List Tunnels
52
6## List Tunnels
3**GET** `/v1/tunnels`
74
8**get** `/v1/tunnels`
9
105The Tunnels API is in research preview. It requires the `anthropic-beta: mcp-tunnels-2026-06-22` header and may change without a deprecation period. It supersedes the Admin API endpoints at `/v1/organizations/tunnels`, which remain available during a migration window.
116
127Lists tunnels. Results are ordered by creation time, newest first; archived tunnels are excluded unless include_archived is set.
138
14### Query Parameters
9## Query parameters
1510
1611- `include_archived: optional boolean`
1712
from line 16
2116
2217 Maximum number of tunnels to return per page. Defaults to 20, maximum 1000.
2318
19 format: int32
20
2421- `page: optional string`
2522
2623 Opaque pagination cursor from a previous `list_tunnels` response.
2724
28### Header Parameters
25## Headers
2926
3027- `"anthropic-beta": optional array of AnthropicBeta`
3128
from line 100
103100
104101 - `"mid-conversation-tool-changes-2026-07-01"`
105102
106### Returns
103## Returns
107104
108105- `data: array of BetaTunnel`
109106
from line 114
117114
118115 A timestamp in RFC 3339 format
119116
117 format: date-time
118
120119 - `created_at: string`
121120
122121 A timestamp in RFC 3339 format
123122
123 format: date-time
124
124125 - `display_name: string or null`
125126
126127 Human-readable name for the tunnel (1-255 characters). Null if unset.
from line 132
131132
132133 - `type: "tunnel"`
133134
134 - `"tunnel"`
135
136135- `next_page: string or null`
137136
138137 Pagination cursor for the next page, or null if no more results.
139138
140### Example
139## Example
141140
142```http
141```bash
143142curl https://api.anthropic.com/v1/tunnels \
144143 -H 'anthropic-version: 2023-06-01' \
145144 -H 'anthropic-beta: mcp-tunnels-2026-06-22' \
from line 145
146145 -H "X-Api-Key: $ANTHROPIC_API_KEY"
147146```
148147
149#### Response
148### Response (200)
150149
151150```json
152151{
No line in this hunk matches that.