HTTP API

Tunnel Status

Check whether a session is connected over the HTTP API.

Docs for LLMs

Check whether a client is connected to a session. No token is needed.

GET/api/agent/tunnels/:subdomain
JSON
{
  "subdomain": "tunnel-a1b2c3d4",
  "publicUrl": "https://tunnel-a1b2c3d4.otterkit.app",
  "connected": true
}

A webhook endpoint can be live with no client attached, because the server answers it. In that case the response also includes a standby object, so read it before treating connected: false as stopped. Pulses include a pulse object. If the session can't be reached, the response has probeError: true and connected: false; treat that answer as unknown, not as stopped.