API Reference

MindCradle provides a secure REST API for clients to perform authentication, log reflections, retrieve daily insights, and query personal knowledge graphs.

Authentication

All authenticated routes require forwarding the Supabase access token in the headers:

Authorization: Bearer 

---

Endpoints

1. Mood Check-ins

- POST `/api/mood`: Submit a new mood level and energy reflection. - GET `/api/mood/history`: Retrieve your historical mood logs.

2. Search Suggestions

- GET `/api/ai/search/suggestions`: Returns a list of default or personalized example queries to run against your history. (This is a public endpoint).

3. AI Insights

- POST `/api/ai/chat`: Send a message to ARIA and receive a relational response grounded in your knowledge graph. - GET `/api/ai/insight`: Get a brief daily summary of your self-awareness patterns.

For more details on how these endpoints verify user identities, check out [Security & Privacy](/docs/security).