Conversations API

Create Conversation

POST /v1/conversations
{
  "userId": "user-123",
  "title": "Debug session"
}

Add Message

POST /v1/conversations/:id/messages
{
  "role": "user",
  "content": "Why is my JWT expiring too fast?",
  "storeAsMemory": true
}

Set storeAsMemory: true to automatically save the message as a memory.

Get Messages

GET /v1/conversations/:id/messages?limit=50&offset=0

Other Endpoints

• GET /v1/conversations/:id — get conversation details
• GET /v1/conversations/:id/stats — message counts, token usage
• GET /v1/users/:userId/conversations — list user conversations
• POST /v1/conversations/:id/close — mark as inactive
• DELETE /v1/conversations/:id — delete conversation and messages