# API reference (/docs/api-reference)

> REST + Python SDK reference for the OmniDimension platform with an interactive try-it-out playground.





The OmniDimension API lets you create agents, dispatch calls, manage
phone numbers, and pull call analytics from your own systems. Auth is a
single Bearer API key on every request.

<Callout type="info" title="Every endpoint is interactive">
  Open any endpoint below and you will find a live playground. Paste
  your API key under **Authorization*&#x2A;, fill in the request, and hit
  **▶ Run** to see the real response without leaving the docs. Your
  key is held in this browser session only — it's wiped on reload.
</Callout>

**Base URL** <BaseUrl />  · 
**Auth** `Authorization: Bearer <YOUR_API_KEY>`

## Endpoint groups [#endpoint-groups]

<Cards>
  <Card icon="<Bot />" title="Agents" href="/docs/api-reference/agents/listAgents" description="Create, retrieve, update, and delete AI voice agents." />

  <Card icon="<PhoneCall />" title="Calls" href="/docs/api-reference/calls/dispatchCall" description="Dispatch calls and retrieve call logs." />

  <Card icon="<PhoneOutgoing />" title="Bulk calls" href="/docs/api-reference/bulk-calls/fetchBulkCalls" description="Outbound campaigns. Schedule, retry, pause, resume, and monitor live status." />

  <Card icon="<BookOpen />" title="Knowledge base" href="/docs/api-reference/knowledge-base/listKnowledgeBaseFiles" description="Upload, list, attach, detach, and delete PDF documents on agents." />

  <Card icon="<Phone />" title="Phone numbers" href="/docs/api-reference/phone-numbers/listPhoneNumbers" description="List, attach, detach, and import from Twilio, Exotel, or SIP." />

  <Card icon="<Cpu />" title="Providers" href="/docs/api-reference/providers/listLLMProviders" description="LLM, voice, STT, and TTS provider catalog." />

  <Card icon="<FlaskConical />" title="Simulation" href="/docs/api-reference/simulation/createSimulation" description="Run automated agent test simulations." />
</Cards>