route_unavailable
No carrier can carry this message within its constraints
HTTP 503route_unavailable
Every route for this destination is unavailable, or none fits the cost cap you set.
Why it happens
- A
max_cost_usdlower than any route to that country. - A destination this deployment has no carrier for.
- Every carrier for the destination is failing at once, which is rare and usually brief.
How to fix it
- Raise or drop
routing.max_cost_usdand try again. The published per-country rates say what a route actually costs. - Retry with backoff: this is the one 5xx worth retrying, because carrier health changes minute to minute.
Is it worth retrying?
Yes, with backoff, reusing the same idempotency key.
What the response looks like
HTTP/1.1 503
Content-Type: application/json
Woyra-Request-Id: req_01J...
{
"error": {
"code": "route_unavailable",
"message": "…",
"doc_url": "https://docs.woyra.io/errors/route_unavailable",
"param": null,
"request_id": "req_01J..."
}
}