Create Tunnel Certificate
Changed onThe 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.
Registers a public CA certificate on a tunnel. Anthropic verifies the gateway's server certificate against this CA when it terminates the inner TLS session. A tunnel holds at most two non-archived certificates.
Request
- Base URLhttps://api.anthropic.com
- Authnone declared
Path parameters
ID of the tunnel (tnl_...).
Headers
The version of the Claude API you want to use.
Read more about versioning and our version history here.
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.
Request body
Response
Successful response (OK)
Changes
- info
added the enum value
user-profiles-billing-2026-10-01to the propertyitems/anyOf[subschema #2]/of theheaderrequest parameteranthropic-beta
- info
- info
added the enum value
admin-user-sign-out-2026-10-08to the propertyitems/anyOf[subschema #2]/of theheaderrequest parameteranthropic-beta
- info