Loading...
Build powerful voice AI applications with our REST API. Initiate calls, manage agents, receive webhooks, and access analytics programmatically.
Enterprise-grade API infrastructure
Secure Bearer token authentication with scoped permissions.
Sub-100ms API response times for real-time operations.
API endpoints served from edge locations worldwide.
Enterprise-grade reliability with SLA guarantees.
Instant notifications for call events and updates.
Clean, consistent JSON format across all endpoints.
Make your first API call in minutes
Get API Key
Sign up and generate your API key from the dashboard
Configure Agent
Create an AI agent with your custom prompt and voice
Make Calls
Use the API to initiate outbound calls or handle inbound
Example: Initiate Outbound Call
cURL
curl -X POST https://api.edesy.in/v1/calls/outbound \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+919876543210",
"agent_id": "agent_abc123",
"context": {
"customer_name": "Raj",
"order_id": "ORD-12345"
}
}'Python
import requests
response = requests.post(
"https://api.edesy.in/v1/calls/outbound",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"phone_number": "+919876543210",
"agent_id": "agent_abc123",
"context": {
"customer_name": "Raj",
"order_id": "ORD-12345"
}
}
)
call = response.json()
print(f"Call ID: {call['id']}")Node.js
const response = await fetch(
'https://api.edesy.in/v1/calls/outbound',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
phone_number: '+919876543210',
agent_id: 'agent_abc123',
context: {
customer_name: 'Raj',
order_id: 'ORD-12345',
},
}),
}
);
const call = await response.json();
console.log('Call ID:', call.id);Core endpoints for voice AI operations
/v1/calls/outboundInitiate an outbound AI voice call
/v1/calls/{call_id}Get call details and transcript
/v1/agentsCreate a new AI voice agent
/v1/agentsList all configured agents
/v1/webhooksRegister webhook endpoint
/v1/analyticsGet call analytics and metrics
Real-time notifications for call lifecycle events
call.startedTriggered when a call begins
call.completedTriggered when a call ends
call.transferredTriggered when call transfers to human
transcript.readyTriggered when transcript is available
agent.updatedTriggered when agent config changes
error.occurredTriggered on call errors
Webhook Payload Example
{
"event": "call.completed",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"call_id": "call_xyz789",
"agent_id": "agent_abc123",
"phone_number": "+919876543210",
"duration_seconds": 180,
"status": "completed",
"transcript_url": "https://api.edesy.in/v1/calls/call_xyz789/transcript"
}
}All API requests require authentication using Bearer tokens. Include your API key in the Authorization header.
API keys are scoped to your organization
Create multiple keys for different environments
Keys can be rotated without downtime
Webhook secrets for payload verification
Authorization Header
Authorization: Bearer sk_live_xxxxxxxxxxxxxReplace sk_live_xxxxxxxxxxxxx with your actual API key from the dashboard.
Get started faster with our official libraries
Python
pip install edesy-voice
Node.js
npm install @edesy/voice
PHP
composer require edesy/voice
Explore more about AI Voice Assistant
Common questions about API integration
API access is included with all paid plans. Sign up for a free trial to get your API key. Enterprise customers get dedicated API keys with higher rate limits.
Standard plans include 100 requests/minute. Enterprise plans have custom rate limits up to 10,000 requests/minute. Rate limit headers are included in all responses.
Yes, we provide a sandbox environment for testing. Sandbox calls use test phone numbers and don't incur charges. Perfect for development and integration testing.
Register your webhook URL via the API or dashboard. We'll send POST requests with event payloads signed with your webhook secret. Retry logic handles temporary failures.
Yes, our API supports BYOT (Bring Your Own Telephony). Connect your Twilio, Exotel, or other SIP-compatible telephony provider.
We provide official SDKs for Python, Node.js, and PHP. Community SDKs are available for Go, Ruby, and Java. All SDKs are open source on GitHub.