Errors

tunnel_not_provisioned

409 – No Tunnel yet.

No Tunnel yet. Answered with 409.

What it means

A raw-TCP port is claimed on an Identity's Tunnel, and the Identity named has none that is live: its provisioning saga has not reached the tunnel step, or it is being torn down and the Tunnel is already withdrawn.

What to do

Poll GET /api/identities/{handle} until status is ready, then ask again. An Identity that is being deleted never gets a Tunnel back.

The body

{
  "type": "https://tigby.eu/problems/tunnel_not_provisioned",
  "title": "No Tunnel yet",
  "status": 409,
  "detail": "…what was refused, naming this request's own values",
  "code": "tunnel_not_provisioned",
  "doc_url": "https://docs.tigby.eu/errors/tunnel_not_provisioned",
  "agent_hint": "…the next step, for software"
}

Branch on code. The detail names this request's own Handle, id or limit and is not part of the contract.