Public API v1 · Developer guide
Automate Voxovo with omni_sk_ platform keys
Production REST API for agents, phone numbers, campaigns, knowledge search, webhooks, calls, and billing. Designed for server-to-server integrations — CI jobs, CRMs, and agency automation — not browser CORS experiments.
Create keys in Settings → Platform API Keys. Send Authorization: Bearer omni_sk_…. Prefer Idempotency-Key on POSTs. Agency operators may scope a request with X-Client-Workspace-Id. Base URL: https://api.voxovo-ai.com/api
Dashboard vs API auth
Humans sign in on voxovo-ai.com with an email code from info@voxovo-ai.com, then use the app. Servers should use omni_sk_ keys from Settings — never embed dashboard session tokens in backends.
Auth
Send either header. Never put secret keys in browsers.
Authorization: Bearer omni_sk_… # or X-API-Key: omni_sk_… # Agency parent key acting as a client: X-Client-Workspace-Id: <client organization uuid>
401— missing/invalid key402— no credits403— suspended workspace429— concurrency limit- Send
Idempotency-Keyon POSTs to dedupe safely
Endpoints
/v1/agentsList / create agents/v1/agents/{id}Read / update / delete/v1/phone-numbersBYO numbers/v1/campaignsCampaigns/v1/campaigns/{id}/start|pause|resumeCampaign control/v1/knowledgeCollections/v1/knowledge/{id}/searchSearch chunks/v1/webhooksPost-call webhook URLs/v1/callsStart call/v1/calls/{id}Status + transcript + latency/v1/billingCredits + concurrencyCopy-paste examples
List agents
curl -s https://api.voxovo-ai.com/api/v1/agents \ -H "Authorization: Bearer omni_sk_YOUR_KEY"
Create agent
curl -s -X POST https://api.voxovo-ai.com/api/v1/agents \
-H "Authorization: Bearer omni_sk_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: agent-create-1" \
-d '{"name":"Support","language":"en","system_prompt":"You help callers."}'Start a call
curl -s -X POST https://api.voxovo-ai.com/api/v1/calls \
-H "Authorization: Bearer omni_sk_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: call-1" \
-d '{"agent_id":"AGENT_UUID","mode":"browser"}'Search knowledge
curl -s -X POST https://api.voxovo-ai.com/api/v1/knowledge/COLLECTION_ID/search \
-H "Authorization: Bearer omni_sk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"refund policy","limit":5}'Agency: act as client
curl -s https://api.voxovo-ai.com/api/v1/billing \ -H "Authorization: Bearer omni_sk_PARENT_KEY" \ -H "X-Client-Workspace-Id: CLIENT_ORG_UUID"
Discovery: GET https://api.voxovo-ai.com/api/v1. Interactive OpenAPI: https:/.voxovo-ai.com/api/docs when the API host is up. Carrier setup: Connect Twilio in 5 minutes.