API Reference

Build custom integrations and automate workflows with the Calimatic AI API.

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate API keys in your dashboard settings.

Endpoints

Method	Endpoint	Description
GET	/api/v1/agents	List all agents in your workspace
POST	/api/v1/agents	Create a new agent
GET	/api/v1/agents/:id	Get agent details
PUT	/api/v1/agents/:id	Update agent configuration
DELETE	/api/v1/agents/:id	Delete an agent
POST	/api/v1/agents/:id/message	Send a message to an agent
GET	/api/v1/conversations	List all conversations
GET	/api/v1/analytics	Get analytics data

Code Examples

const response = await fetch('https://api.calimatic.ai/v1/agents/msg', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agent_id: 'agent_123',
    message: 'Hello, I need help with pricing',
    user_id: 'user_456',
  }),
});

const data = await response.json();
console.log(data);

Webhooks

Receive real-time notifications when events occur in your workspace. Configure webhook endpoints in your dashboard settings.

Available Events

• conversation.started - New conversation initiated
• conversation.ended - Conversation completed
• lead.captured - New lead captured by agent
• agent.handoff - Agent requested human handoff
• appointment.booked - Appointment scheduled

Rate Limits

API rate limits vary by plan:

Starter

100

requests/minute

Professional

500

requests/minute

Enterprise

Custom

Contact sales