Skip to main content
Base URL: http://localhost:8000/api/v1

RAG Query

Natural language queries against the user’s memory.
POST /users/{user_id}/rag/query
Content-Type: application/json

{"query": "What projects am I working on?"}
Response:
{
    "query": "What projects am I working on?",
    "response": "Based on your memories, you're working on..."
}

Ask (Structured Insights)

Get structured JSON responses by providing an output schema.
POST /users/{user_id}/ask
Content-Type: application/json

{
    "query": "What are my preferences?",
    "output_schema": {
        "preferences": ["example"],
        "summary": "string"
    }
}
Response:
{
    "result": {
        "preferences": ["remote work", "morning meetings"],
        "summary": "User prefers flexible work arrangements"
    }
}

When to Use Which

Use CaseEndpoint
Conversational responsesRAG Query
Data extraction for UIAsk
Feature personalizationAsk
Chatbot augmentationRAG Query

Error Codes

CodeDescription
400Bad Request - Invalid input
404User not found
500Internal server error
502External service (LLM) error
503Database connection error