Skip to Content
APIEndpointsEndpoints

Endpoints

REST endpoints grouped by resource. Every endpoint requires authentication and counts against the relevant rate limit.

ResourceCommon operations
AgentsCreate / update voice personas (name, voice ID, language)
CampaignsOutbound calling campaigns. Owns calls, contacts, stats, settings.
CallsInspect calls, fetch transcripts, place outbound
Phone NumbersSearch, purchase, port-in, manage routing
BusinessesBusiness profile, hours, services, prompts, settings
WebhooksSubscribe to call events

Architectural note

Akol’s data model: Agents are minimal — voice ID + name only. Everything else (calls, contacts, stats, phone numbers, analytics, settings) lives on Campaigns. When designing integrations:

  • Read agent configuration from the Business profile, not the Agent.
  • Group call data by Campaign, not Agent.
  • An Agent (voice persona) can be reused across multiple Campaigns.

This means most “what’s happening with my AI agent” queries are actually “what’s happening with my campaign” queries.

Last updated on