Tunnels

Tunnels expose a local development server to Aiqaramba's agents and browsers through an encrypted connection, without making it reachable from the public internet. Open a tunnel with 'aiqa tunnel <port>'; the assigned hostname stays reachable only from inside Aiqaramba's network. A tunnel lives exactly as long as its connection: closing the CLI closes the tunnel.

GET /api/v1/tunnels

List your open tunnels

Returns the organization's live tunnels, newest first, with per-tunnel traffic statistics. Byte counters are measured at the public side of the tunnel: bytes_in is traffic from Aiqaramba's browsers toward the local server, bytes_out is response traffic back. Counters cover TCP connections, not HTTP requests: one keep-alive connection can carry several requests.

Status Codes

Code	Description
`200`	OK
`401`	Unauthorized
`503`	Tunnels are not configured on this server

Response Body

{
  "tunnels": [
    {
      "host": "hx7f2k9q3wm1aaaa.tunnel.aiqaramba.com",
      "state": "open",
      "created_at": "2026-07-27T09:14:00Z",
      "last_activity": "2026-07-27T09:21:42Z",
      "active_connections": 2,
      "total_connections": 148,
      "bytes_in": 1204833,
      "bytes_out": 90233411,
      "client_address": "203.0.113.7"
    }
  ]
}

API Key

cURL

Response