Conversational AI over the RRM Research Library

Answers questions scoped to restorative reproductive medicine using the RRM Library corpus. Two auth paths:

Session-authenticated (20 req/day): Include the session cookie from /api/auth/login. Supports both JSON and SSE response formats based on the Accept header.

Anonymous (2 req/day/IP): No cookie required. Always returns text/event-stream. Rate-limited per IP.

Set Accept: text/event-stream to receive a streaming SSE response regardless of auth state.

post/api/ask

Request

  • Base URL: https://rrmacademy.org
  • URL: https://rrmacademy.org/api/ask
  • Auth: none required

Headers

Idempotency-Keystring
Example:f47ac10b-58cc-4372-a567-0e02b2c3d479

Opaque client-generated identifier (recommend 36-character UUID) that lets the server detect retried requests on this mutation endpoint and return the cached prior response instead of re-running side effects. Implements the IETF idempotency-header draft (https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/). Constraints: 16-128 printable ASCII characters. The server returns the same status, body, and Idempotency-Replayed: true on a successful match. If the same key is reused with a different request body, the server returns 422 with error=idempotency-mismatch. Keys expire after 24 hours. Idempotency is opt-in: requests without this header behave exactly as before.

Request body

messagestring required

The question to ask the RRM Library AI

Response

Answer with citations. Content-Type is application/json for authenticated requests without SSE Accept header, or text/event-stream for anonymous requests and any SSE-accepting request.

answerstring required

AI-generated answer scoped to RRM Library content

fallbackboolean

true when no relevant library content was found and a fallback message is returned

Changes

No recorded changes to this operation across all 1 revision of this API.