🔌 API Documentation

Complete reference for all backend endpoints.

Base URL

Most endpoints don't require authentication for MVP. Later we'll add Auth0 integration.

Send a message and get a response.

Request:

{
  "text": "Hello, what's the weather?",
  "user_id": "user123",
  "conversation_id": "conv456"
}

Response:

{
  "response": "I don't have access to weather data...",
  "status": "ok"
}

Status Codes:

Save a message to the database.

Load previous messages for a conversation.

Delete messages from a conversation.

Save a chat session.

Get audio for a message.

Generate TTS audio.

Health check endpoint.

Response:

{ "status": "ok" }

Check Neo4j connection status.

Get AI personality traits.

All errors return JSON:

{
  "detail": "Error message here",
  "status": "error"
}

Currently no rate limiting implemented. Will add later if needed.

Webhooks not yet implemented.

See FastAPI Docs for general guidance.