REST API

Programmatic access to your AI agent via HTTP endpoints.

Base URL

https://api.your-domain.com/v1

All 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/chat

Send 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/conversations

Returns a paginated list of conversations.

Get Conversation

GET /v1/conversations/:id

Returns a single conversation with its message history.

Rate Limits

PlanRequests/minRequests/day
Free201,000
Pro10010,000
EnterpriseCustomCustom

See the API Reference for the complete endpoint documentation.

On this page