Developers

API Reference

Full REST API for agents, calls, campaigns, and analytics. Authenticate with your workspace API key.

Base URL and auth

bash

https://api.katexs.com/v1

Authorization: Bearer <KATEXS_API_KEY>

Endpoints

Method	Path	Description
GET	/agents	List agents
POST	/agents	Create an agent
PATCH	/agents/:id	Update agent configuration
POST	/agents/:id/deploy	Set an agent live
GET	/calls	List calls with filters
GET	/calls/:id	Fetch a transcript and outcome
POST	/campaigns	Create a campaign
POST	/campaigns/:id/launch	Launch a campaign

Create an agent

bash

curl -X POST https://api.katexs.com/v1/agents \
  -H "Authorization: Bearer $KATEXS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Front Desk",
    "type": "voice",
    "voice_id": "elevenlabs:rachel",
    "prompt": "You are the receptionist for Bright Dental...",
    "tools": ["check_calendar", "book_appointment"]
  }'

Errors and limits

Status	Meaning
400	Validation error — see the details array
401	Missing or invalid API key
429	Rate limited — 120 requests per minute
5xx	Retry with exponential backoff