Список туннелей

Deprecated

GET/v1/organizations/tunnels

Устарело. Эта конечная точка Admin API заменена /v1/tunnels в Claude API и будет удалена после окончания периода миграции. Новым интеграциям следует использовать /v1/tunnels с заголовком anthropic-beta: mcp-tunnels-2026-06-22 и токеном WIF с областью действия workspace:manage_tunnels. Существующие интеграции продолжают работать с заголовком mcp-tunnels-2026-05-19 и областью действия org:manage_tunnels в течение периода миграции.

Получить список туннелей организации.

Результаты охватывают организацию вызывающей стороны и упорядочены по времени создания (сначала новые). Используйте workspace_id для фильтрации по одному рабочему пространству; архивированные туннели исключаются, если не задан include_archived.

Query parameters

include_archived: optional boolean

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

defaultfalse

limit: optional number

Maximum number of tunnels to return in a single page.

default20

maximum1000

minimum1

page: optional string

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

workspace_id: optional string

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

Headers

"anthropic-beta": array of "mcp-tunnels-2026-05-19"

Required for all Tunnel endpoints.

Returns

data: array of object{ id, archived_at, created_at, 4 more }

id: string

ID of the Tunnel.

archived_at: string or null

RFC 3339 datetime string indicating when the Tunnel was archived, or null if it is not archived.

formatdate-time

created_at: string

RFC 3339 datetime string indicating when the Tunnel was created.

formatdate-time

display_name: string or null

Human-readable name for the Tunnel (1–255 characters), or null if unset.

domain: string

Anthropic-assigned hostname for the Tunnel. MCP server URLs whose host is a subdomain of this value are routed through the Tunnel. Globally unique and never reused, even after the Tunnel is archived.

type: "tunnel"

Object type. Always tunnel for Tunnels.

defaulttunnel

workspace_id: string or null

ID of the Workspace this Tunnel belongs to, or null for the default Workspace. Immutable after creation.

next_page: string or null

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

Список туннелей

cURL

curl https://api.anthropic.com/v1/organizations/tunnels \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Response 200

{
  "data": [
    {
      "id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
      "archived_at": "2024-11-01T23:59:27.427722Z",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "Production",
      "domain": "a1b2c3d4.tunnel.anthropic.com",
      "type": "tunnel",
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
      "archived_at": "2024-11-01T23:59:27.427722Z",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "Production",
      "domain": "a1b2c3d4.tunnel.anthropic.com",
      "type": "tunnel",
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}