Skip to content

Document the destination_route_unavailable proxy error #676

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
meliaj wants to merge 2 commits into from
Closed

Document the destination_route_unavailable proxy error #676

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c0a8b93
Document the destination_route_unavailable proxy error
meliaj Oct 5, 2026
0a82b2b
Say a new browser is needed when a route's proxy is unavailable
meliaj Oct 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions proxies/errors.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ The header is set on every branded proxy-layer error response, including WebSock
| `restricted_route_unavailable` | The destination requires a specialized egress route and Kernel could not build one. Kernel will not fall back to a provider known to reject the destination. | Yes, except on `.gov` destinations. There, create a new residential proxy with no targeting, country-only targeting, or a U.S. state, confirm it with [`POST /proxies/{id}/check`](https://kernel.sh/docs/api-reference/proxies/check-proxy-health), then use it for the session. |
| `proxy_unavailable` | A failure inside Kernel's own proxy layer, not your automation or the destination. | Yes |
| `origin_response_incomplete` | The destination closed the connection before sending a complete response. | Only if safe. The destination may have received the request, so retry only when repeating the action cannot cause duplicate changes. |
| `destination_route_unavailable` | The destination matches one of the session's [`network.proxy_routes`](/api-reference/browsers/create-a-browser-session), but that route's proxy is unavailable, for example because it was deleted. Kernel does not fall back to the session's proxy or a direct connection. | No. Routes can't be changed on a running browser, so create a new browser whose route uses an available proxy, or one without the route. If the route's proxy still exists, contact support with the error code. |
| `provider_rejected` | The upstream proxy provider rejected the request before the destination connection was established. | No. Try a different proxy or proxy type, and check the credentials on a [custom proxy](/proxies/custom). |
| `provider_blacklisted` | The upstream proxy provider blocks this destination. | No. Try a different proxy or proxy type, or disable the proxy for this destination. |
| `destination_blocked` | Kernel policy blocks connections to internal and private addresses. | No. Use a public destination address. |
Expand Down
Loading