# Readsmith site API

The HTTP surface every self-hosted Readsmith site serves: hybrid search, streamed Ask AI answers, reader feedback, and capability discovery. All endpoints are public and rate limited per client IP; none require authentication.

* Base URL: `https://readsmith.dev/docs`
* Version: 0.1.0

## Search

Hybrid full-text plus vector search over the site's content.

* [`POST` Search the docs](/docs/api-reference/searchdocs)

## Ask AI

Grounded, cited answers streamed over server-sent events.

* [`POST` Ask a question](/docs/api-reference/askdocs)
* [`POST` Rate an answer](/docs/api-reference/sendfeedback)

## Meta

Health and capability discovery.

* [`GET` Which AI features are live](/docs/api-reference/getcapabilities)
* [`GET` Health check](/docs/api-reference/gethealth)