HTTP status: 504 · Title: “Gateway timeout” · Retry-After: 5sDocumentation Index
Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
Use this file to discover all available pages before exploring further.
When it fires
The per-request server timeout fired (default 30 s). Bounded bybodyLimit + Fastify timeout config to keep slow upstreams from blocking healthy traffic.
Why it happens
- An unusually slow downstream call (Postgres lock contention, RPC latency spike, etc.).
- A request that does too much work in one call — most reads complete in
<100 ms. - Network path degradation between you and our edge (rare but possible).
How to fix
- Retry once with backoff. Most timeouts are transient.
- If you’re consistently timing out on the same endpoint, narrow the request — pass
limitparameters, fetch one resource at a time. - For long-running operations, use webhooks instead of waiting on the response.