Claude Platform Docs

터널 인증서 목록 조회

$ ant beta:tunnels:certificates list
GET/v1/tunnels/{tunnel_id}/certificates

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널에 등록된 인증서 목록을 조회합니다. include_archived가 설정되지 않은 경우 보관된 인증서는 제외됩니다.

Parameters
--tunnel-id: string⁠Path parameter

ID of the tunnel (tnl_...).

--include-archived: optional boolean⁠Query parameter

Whether to include archived certificates in the results. Defaults to false.

--limit: optional number⁠Query parameter

Maximum number of certificates to return per page. Defaults to 20, maximum 1000.

formatint32
--page: optional string⁠Query parameter

Opaque pagination cursor from a previous list_tunnel_certificates response.

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send mcp-tunnels-2026-06-22 in this header.

--workspace-id: optional string⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
BetaListTunnelCertificatesResponse: object{ data, next_page }

The tunnel's certificates.

data: array of BetaTunnelCertificate { type: "tunnel_certificate", id, archived_at, 4 more }

List of certificates, ordered by created_at descending.

type: "tunnel_certificate"
id: string

Unique identifier for the certificate, prefixed with tcrt_.

archived_at: string

RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the certificate was registered.

formatdate-time
expires_at: string

RFC 3339 datetime string indicating when the certificate expires, or null if it does not expire.

formatdate-time
fingerprint: string

Lowercase hex SHA-256 fingerprint of the certificate's DER encoding.

tunnel_id: string

ID of the tunnel the certificate is registered against.

next_page: string

Pagination cursor for the next page, or null if no more results.

터널 인증서 목록 조회
ant beta:tunnels:certificates list \
  --api-key my-anthropic-api-key \
  --tunnel-id tunnel_id
Returns Examples
Response 200
{
  "data": [
    {
      "id": "id",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_at": "2019-12-27T18:11:19.117Z",
      "expires_at": "2019-12-27T18:11:19.117Z",
      "fingerprint": "fingerprint",
      "tunnel_id": "tunnel_id",
      "type": "tunnel_certificate"
    }
  ],
  "next_page": "next_page"
}