Skip to main content
The XUNA AI Conversational AI API lets you create and manage voice agents, retrieve conversation history, and control telephony integrations — all over HTTP. Every endpoint is available under a single base URL and secured with an API key.

​
Base URL

All API requests go to: 
https://api.xuna.ai

​
Authentication

Pass your API key in the xi-api-key request header on every call: 
curl https://api.xuna.ai/v1/convai/agents \
  -H "xi-api-key: YOUR_API_KEY"
Get your API key from Settings → API Keys. Store it as an environment variable rather than hard-coding it: 
export XUNA_AI_API_KEY=your_api_key_here
See Authentication for advanced options including signed URLs and conversation tokens for client-side use.

​
SDK installation

The official SDKs wrap every endpoint and handle authentication automatically. 
pip install xuna-ai
Initialize the client with your API key: 
from xuna_ai.client import XunaAI

client = XunaAI(api_key="YOUR_API_KEY")
Set the XUNA_AI_API_KEY environment variable and the SDKs will pick it up automatically — no need to pass api_key explicitly.

​
Rate limits

Rate limits vary by plan. If you exceed your limit, the API returns a 429 Too Many Requests response. Implement exponential backoff and retry logic in production applications.

​
Explore the API

Agents

Create, update, list, and delete voice agents.

Conversations

Retrieve transcripts, audio, and evaluation results.

Phone numbers

Import Twilio numbers and assign agents to inbound calls.

Batch calls

Launch outbound call campaigns with per-call overrides.