Skip to main content

E1302. Approval backend unreachable

Severity: ERROR. Class: HITLBackendUnreachableError (subclass of HostedBootstrapError).

What happened​

The SDK could not POST to /api/approval-requests after the configured retry budget. Network error, DNS failure, backend down, or rate-limit.

Why it matters​

Without a reachable backend, the approval request cannot be created. The SDK falls through to the original deny.

How to fix​

Check api.controlzero.ai from your machine: curl -sI https://api.controlzero.ai/healthz. If reachable, the issue is transient; the SDK will retry on the next call. If unreachable, check your network / proxy / VPN.

Catching this error​

except HostedBootstrapError catches this. The fail-closed behavior matches other hosted-bootstrap failures (bundle fetch, enrollment).

See also​