REST API

Chat with your agents and read conversations from your own code.

Create a key in Settings → API keys Send it as a bearer token. 120 requests a minute per key.

Send a message
POST /api/v1/agents/{agentId}/chat

Body: {"message": "Where is my order 1042?", "conversationId": null, "userId": "customer-123", "email": "[email protected]"}

Response: {"conversationId": "…", "status": "ai", "answer": "…", "sources": [{"title": "…", "url": "…"}], "confidence": 0.86, "followups": ["…"]}

Pass the returned conversationId to continue the conversation. Add "stream": true for Server-Sent Events (start, delta, done).

List conversations
GET /api/v1/conversations?agentId=…&since=2026-10-01&limit=20 returns conversations with their messages, topic, sentiment, resolution and rating.

Agent id
The agent id is in the dashboard URL: /app/agents/{agentId}.