Tunnels Unavailable

tunnels-unavailable · 503

Nothing relays tunnels for the site the database runs in, so the API opened no tunnel.

service and environment name the database and the environment it was asked in. region is the database's region. It is the platform's limit, not the database's or the caller's, and the database keeps running.

Besides the members every error carries, this type adds service, environment and region.

Common causes

  • No relay serves the site the database runs in.
  • The platform has no relay set up at all.

How to fix the call

  • Tell the user that tunnels can't reach this database's region, quoting detail.
  • Reach the database from a service in the same project instead, through its connection variables.
  • Don't retry in a loop: the answer changes only when a relay serves the site.

Example response

json
{
  "type": "tunnels-unavailable",
  "title": "Tunnels Unavailable",
  "detail": "Tunnels are not available in amman-1 yet.",
  "service": "orders-db",
  "environment": "staging",
  "region": "amman-1",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "status": 503,
  "docs": "https://ghaym.me/docs/errors/tunnels-unavailable"
}