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

Ask AI

Grounded, cited answers streamed over server-sent events.

• POST Ask a question
• POST Rate an answer

Meta

Health and capability discovery.

• GET Which AI features are live
• GET Health check