`POST /_readsmith/api/ask`

Answers a question from the site's own content, streaming the reply as a server-sent-events message stream. Answers cite the pages they came from; retrieval grounds the model on full chunks, never previews.

### Request body

`application/json` · required

- `query` string · required · min length: 1 · max length: 2000 — The search query or question.
- `version` string · optional — Docs version to scope to. Defaults to current.
- `locale` string · optional — Locale to scope to. Defaults to en.

### Responses

**200** — The answer as a streamed UI message stream.

`text/event-stream`:

**400**

**429**

**503**
