List Tunnels
Changed onDeprecated. 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.
Request
- Base URLhttps://api.anthropic.com
- Authnone declared. Required headers: anthropic-beta
Query parameters
Opaque pagination cursor from a previous response's next_page. Omit to fetch the first page.
Maximum number of tunnels to return in a single page.
Return only tunnels in this Workspace. Accepts a wrkspc_-prefixed Workspace ID; omit to list tunnels across all Workspaces.
Include archived tunnels in the results. Archived tunnels are excluded by default.
Headers
The version of the Claude API you want to use.
Read more about versioning and our version history here.
Response
Successful Response
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-08to the propertyitems/anyOf[subschema #2]/of theheaderrequest parameteranthropic-beta
- info
- info
added the enum value
experimental-claude-tag-2026-10-21to the propertyitems/anyOf[subschema #2]/of theheaderrequest parameteranthropic-beta
- info