Stream Query

POST 
/api/v1/query/stream

Ask a question in natural language and receive the answer as Server-Sent Events.

The stream carries progress, the result and an end event, or a write's preview, or a refusal.

Summary

POST /api/v1/query/stream is an operation in the query group of the Nexatron REST API, served from https://api.nexatron.io. Send an API key as a bearer token in the Authorization header. It takes a JSON body whose required field is question. A successful call returns 200; the other documented responses are 400, 401, 403, 404, 422 and 429.

Example request

curl -X POST "https://api.nexatron.io/api/v1/query/stream" \
  -H "Authorization: Bearer $NEXATRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"<question>"}'

Placeholders in angle brackets stand for your own values. NEXATRON_API_KEY holds an API key from Settings → API tokens. See the API overview for authentication, errors and rate limits.

Request

Responses

200

Successful Response

400

Malformed or business-invalid request

401

Authentication required or invalid credentials

403

Authenticated but insufficient permissions

404

Resource not found

422

Validation error

429

Rate limited: the workspace's query budget is spent. Back off and retry; no Retry-After is sent. A warehouse capacity refusal arrives as a refusal event in the stream, not as an HTTP 429.