Glossary

world_unreachable

world_unreachable is the 502 code OneLifeVibe returns when a website behind its gateway cannot be reached. Retry it with backoff.

Updated November 12, 2026

At OneLifeVibe

Related terms

What it means

A 502 is an HTTP status code. It means a gateway or proxy could not get a usable response from the server it forwards requests to. The client reached the gateway, but the gateway did not reach the upstream service.

In OneLifeVibe, a 502 with the code world_unreachable means the website behind the gateway cannot be reached. The request did not complete at the website. The condition is treated as temporary, so it is worth a retry.

How it works

Your request reaches the OneLifeVibe gateway. The gateway passes it to the website. When that website cannot be reached, the gateway returns 502 and an error body with an error object. That object has code, message and hint fields.

Use code as the branch point. The message and hint are for people reading logs or support notes. The same code can arrive with different wording, so do not match on the message text.

On the client side, retry with backoff. A short wait and a growing delay between attempts gives the website time to come back. Pair this with a retry schedule with backoff.

How OneLifeVibe uses it

OneLifeVibe returns 502 world_unreachable when the website behind its gateway cannot be reached. Treat it as retryable. The 503 unavailable code is also worth a retry.

The 400, 401, 403, 404 and 501 codes are not worth a retry. A 400 points at the request, 401 and 403 at authentication or permission, 404 at a missing resource, and 501 at an unsupported operation. Retrying those sends the same request into the same answer.

Keep retry logic in one place. Read the code field, decide if the code is in the retryable set, and apply your backoff. Log the message and hint once per attempt so you can see what the gateway reported.

Common mistakes

Retrying every error is the usual mistake. A 404 or 401 will not clear because you tried again with the same credentials or path. Filter on code first.

Another is matching on the message string. Messages can change and can include details for a person. The code is the stable value to test.

Skipping backoff is a third. A tight loop hammers the gateway and the website without giving either a chance to recover. A retry schedule with backoff is the intended pattern.

Questions

What does world_unreachable mean in the OneLifeVibe API?

It is a 502 error that means a website behind the OneLifeVibe gateway cannot be reached. The request did not complete at the website, and the condition is worth a retry with backoff.

Should I retry a 502 world_unreachable error?

Yes. OneLifeVibe treats 502 world_unreachable and 503 unavailable as worth a retry. Do not retry 400, 401, 403, 404 or 501; check the code field and branch on that.

See it working. The OneLifeVibe connector and Platform API put these pieces together.

Get a free key Read the docs

Written from the OneLifeVibe tool registry and platform configuration, and checked automatically before publishing. Something wrong? Tell us.