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.
List live tunnels
Returns the authenticated tenant's live tunnels, newest first.
Example Request
curl
curl "http://app.aiqaramba.com/api/v1/tunnels" \ -H "Authorization: Bearer $AIQA_API_KEY"
Status Codes
| Code | Description |
|---|---|
200 | Live tunnels and traffic statistics. |
401 | Authentication is missing or invalid. |
500 | The server could not complete the request. |
503 | The requested feature is not configured on this server. |
Response Fields (200)
| Field | Type | Description |
|---|---|---|
tunnels | object[] | |
tunnels[].host | string | |
tunnels[].state | string | Values: opening, open. |
tunnels[].created_at | date-time | |
tunnels[].last_activity | date-time | |
tunnels[].active_connections | integer | |
tunnels[].total_connections | integer | |
tunnels[].bytes_in | integer | |
tunnels[].bytes_out | integer | |
tunnels[].client_address | string |