REST API
Programmatic access to your AI agent via HTTP endpoints.
Base URL
https://api.your-domain.com/v1All API requests require authentication via an API key passed in the Authorization header.
Authentication
curl https://api.your-domain.com/v1/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Endpoints
Send Message
POST /v1/chatSend a message to your agent and receive a response.
Request Body:
{
"message": "How do I reset my password?",
"conversation_id": "conv_abc123",
"stream": false
}Response:
{
"id": "msg_xyz789",
"conversation_id": "conv_abc123",
"content": "To reset your password, navigate to Settings > Security...",
"created_at": "2025-01-15T10:30:00Z"
}List Conversations
GET /v1/conversationsReturns a paginated list of conversations.
Get Conversation
GET /v1/conversations/:idReturns a single conversation with its message history.
Rate Limits
| Plan | Requests/min | Requests/day |
|---|---|---|
| Free | 20 | 1,000 |
| Pro | 100 | 10,000 |
| Enterprise | Custom | Custom |
See the API Reference for the complete endpoint documentation.