{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mireye Earth Ask API",
    "version": "0.14.0"
  },
  "items": [
    {
      "info": {
        "name": "Ask",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Natural-language Q&A over a US coordinate (LLM-backed)",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "{{baseUrl}}/v1/ask",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Plans which catalog fields to fetch, fetches them, and synthesizes a cited answer. Much slower than `/v1/fetch`: typically ~6-20 s, hard-bounded at 110 s (then a `504 ask_timeout`). **Set a client timeout of at least 120 s.** For progressive output (first tokens ~5-7 s) use `POST /v1/ask/stream`. Returns `429 ask_busy` when the fleet-wide concurrency cap is saturated; retryable failures carry a `Retry-After` header."
        },
        {
          "info": {
            "name": "Streaming (SSE) natural-language Q&A over a US coordinate",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "{{baseUrl}}/v1/ask/stream",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Server-Sent Events variant of `/v1/ask`, same request body. Emits `delta` frames as the answer is synthesized (first tokens ~5-7 s), then one terminal `final` frame carrying the full `/v1/ask` body, or an `error` frame on mid-stream failure. Same 110 s deadline and `429 ask_busy` back-pressure as the buffered route; failures before the first byte surface as a real HTTP status (with `Retry-After` when retryable). Set a client timeout of at least 120 s."
        }
      ]
    }
  ],
  "bundled": true
}