query_timeout

What happened

Your query ran past the time limit and was cancelled before it finished.

Why it usually happens

The query tried to scan more data than it could get through inside the per-request time limit — usually a wide date range, or no filter to cut the rows down.

How to fix

• Narrow the date range.
• Add a filter to cut the number of rows scanned.
• Aggregate in the query rather than fetching raw rows.
• Retry once — transient load can push a borderline query over the edge.

Envelope

{
  "error": {
    "code": "query_timeout",
    "message": "Query exceeded the configured time limit. Try a narrower date range, or this view may need optimization.",
    "param": null,
    "doc_url": "https://docs.fullvision.io/errors/query_timeout",
    "trace_id": "tr_01HXYZ..."
  }
}