v1

latestSwagger 2.02026-08-06114111152.5 KB

Tunnel

Create a tunnel

Launches a new TestingBot Tunnel VM and returns its connection metadata. Most users start tunnels via the tunnel client/CLI rather than this endpoint directly.

post/v1/tunnel/create

Response

Create a tunnel

idinteger required

Unique numeric tunnel ID.

statestring required

Tunnel lifecycle state (READY, STOPPED, …).

launchedstring date-time required

When the tunnel was launched.

tunnel_idstring required

Public tunnel identifier surfaced in the dashboard.

identifierstring required

Custom name passed via --tunnel-identifier on the client.

metadataobject required

Free-form metadata (client version, OS, region) reported by the tunnel binary.