# OneInbox

> Voice orchestration platform for AI agents

## Docs

- [Create Agent](https://docs.oneinbox.ai/api-reference/agents/create-agent.md)
- [Delete Agent](https://docs.oneinbox.ai/api-reference/agents/delete-agent.md)
- [Get Agent](https://docs.oneinbox.ai/api-reference/agents/get-agent.md)
- [List Agents](https://docs.oneinbox.ai/api-reference/agents/list-agents.md)
- [Update Agent](https://docs.oneinbox.ai/api-reference/agents/update-agent.md)
- [List Audit Events](https://docs.oneinbox.ai/api-reference/audit-events/list-audit-events.md)
- [Create Call](https://docs.oneinbox.ai/api-reference/calls/create-call.md): Create an outbound phone call. Matches the published spec.
- [Delete Call](https://docs.oneinbox.ai/api-reference/calls/delete-call.md)
- [Get Call](https://docs.oneinbox.ai/api-reference/calls/get-call.md)
- [List Calls](https://docs.oneinbox.ai/api-reference/calls/list-calls.md)
- [List calls (cursor pagination)](https://docs.oneinbox.ai/api-reference/calls/list-calls-cursor-pagination.md): Cursor-paginated alternative to GET /v1/calls. Pass back the `next_cursor` value to fetch the next page. Recommended over offset pagination for large call lists (>10k rows) because it is O(log n) per page instead of O(offset+limit).
- [Patch Call](https://docs.oneinbox.ai/api-reference/calls/patch-call.md): Set the call's outcome label. Outcome is the only mutable field — everything else (transcript, recording, duration, etc.) is worker-owned and only updatable via the internal endpoints.
- [Stop Call](https://docs.oneinbox.ai/api-reference/calls/stop-call.md)
- [Health](https://docs.oneinbox.ai/api-reference/health/health.md)
- [Create integration](https://docs.oneinbox.ai/api-reference/integrations/create-integration.md)
- [Delete integration](https://docs.oneinbox.ai/api-reference/integrations/delete-integration.md)
- [Get integration](https://docs.oneinbox.ai/api-reference/integrations/get-integration.md)
- [List integrations](https://docs.oneinbox.ai/api-reference/integrations/list-integrations.md)
- [Update integration](https://docs.oneinbox.ai/api-reference/integrations/update-integration.md)
- [Add a knowledge base source — file, URL, or inline text (auto-creates the KB)](https://docs.oneinbox.ai/api-reference/knowledge-bases/add-a-knowledge-base-source-—-file-url-or-inline-text-auto-creates-the-kb.md): The single endpoint to add content to a knowledge base. You don't create a KB first — we auto-create one (named from `name`, the filename, or the URL) and attach your source. Returns a `job_id`; ingestion (parse → S3 → token count → vector index) runs in the background — poll `GET /v1/knowledge-base…
- [Delete a knowledge base source (file / URL / inline text)](https://docs.oneinbox.ai/api-reference/knowledge-bases/delete-a-knowledge-base-source-file-url-inline-text.md): Removes a single source from the KB along with its vector chunks and the stored file (S3). Get the `source_id` from `GET /v1/knowledge-bases/{kb_id}/sources`. Returns 404 if the source doesn't exist in this KB.
- [Delete Kb](https://docs.oneinbox.ai/api-reference/knowledge-bases/delete-kb.md)
- [Get Kb](https://docs.oneinbox.ai/api-reference/knowledge-bases/get-kb.md)
- [Get Kb Job](https://docs.oneinbox.ai/api-reference/knowledge-bases/get-kb-job.md): Poll the status of a background ingestion / indexing job.
- [List Kb Jobs](https://docs.oneinbox.ai/api-reference/knowledge-bases/list-kb-jobs.md): Recent jobs for this KB (most-recent first, up to 20).
- [List Kb Sources](https://docs.oneinbox.ai/api-reference/knowledge-bases/list-kb-sources.md)
- [List Kbs](https://docs.oneinbox.ai/api-reference/knowledge-bases/list-kbs.md)
- [Update Kb](https://docs.oneinbox.ai/api-reference/knowledge-bases/update-kb.md)
- [Create Model](https://docs.oneinbox.ai/api-reference/llm-models/create-model.md)
- [Delete Model](https://docs.oneinbox.ai/api-reference/llm-models/delete-model.md)
- [Get Model](https://docs.oneinbox.ai/api-reference/llm-models/get-model.md)
- [Get Model Catalogue](https://docs.oneinbox.ai/api-reference/llm-models/get-model-catalogue.md): List the accepted `model` ids for a (kind, provider) so clients can pick a valid value — and power the model dropdown — without first POSTing a wrong one (#15). Declared BEFORE `/{model_id}` so 'catalogue' is never parsed as a model id.
- [List Models](https://docs.oneinbox.ai/api-reference/llm-models/list-models.md)
- [Update Model](https://docs.oneinbox.ai/api-reference/llm-models/update-model.md)
- [Delete Phone Number](https://docs.oneinbox.ai/api-reference/phone-numbers/delete-phone-number.md)
- [Get Phone Number](https://docs.oneinbox.ai/api-reference/phone-numbers/get-phone-number.md)
- [List Phone Numbers](https://docs.oneinbox.ai/api-reference/phone-numbers/list-phone-numbers.md)
- [Purchase Phone Number](https://docs.oneinbox.ai/api-reference/phone-numbers/purchase-phone-number.md): Buy a phone number through OneInbox and wire it to an agent in one step.
- [Register Phone Number](https://docs.oneinbox.ai/api-reference/phone-numbers/register-phone-number.md)
- [Search Available Numbers](https://docs.oneinbox.ai/api-reference/phone-numbers/search-available-numbers.md): Search phone numbers available to buy through OneInbox.
- [Update Phone Number](https://docs.oneinbox.ai/api-reference/phone-numbers/update-phone-number.md)
- [Create Tool](https://docs.oneinbox.ai/api-reference/tools/create-tool.md)
- [Delete Tool](https://docs.oneinbox.ai/api-reference/tools/delete-tool.md)
- [Get Tool](https://docs.oneinbox.ai/api-reference/tools/get-tool.md)
- [List Tools](https://docs.oneinbox.ai/api-reference/tools/list-tools.md)
- [Update Tool](https://docs.oneinbox.ai/api-reference/tools/update-tool.md)
- [Get Usage](https://docs.oneinbox.ai/api-reference/usage/get-usage.md)
- [Get Voice](https://docs.oneinbox.ai/api-reference/voices/get-voice.md)
- [Import Voice](https://docs.oneinbox.ai/api-reference/voices/import-voice.md)
- [List Voices](https://docs.oneinbox.ai/api-reference/voices/list-voices.md)
- [Create Webhook](https://docs.oneinbox.ai/api-reference/webhooks/create-webhook.md)
- [Delete Webhook](https://docs.oneinbox.ai/api-reference/webhooks/delete-webhook.md)
- [Get Webhook](https://docs.oneinbox.ai/api-reference/webhooks/get-webhook.md)
- [List Webhook Deliveries](https://docs.oneinbox.ai/api-reference/webhooks/list-webhook-deliveries.md): Delivery-attempt log for this webhook. Partners use this to verify we tried to deliver a specific event without filing a support ticket. Newest attempt first. Includes response_status / response_body / error fields from the most recent attempt on each row.
- [List Webhooks](https://docs.oneinbox.ai/api-reference/webhooks/list-webhooks.md)
- [Test Webhook](https://docs.oneinbox.ai/api-reference/webhooks/test-webhook.md)
- [Update Webhook](https://docs.oneinbox.ai/api-reference/webhooks/update-webhook.md)
- [Create Call Outcome](https://docs.oneinbox.ai/api-reference/workspace/create-call-outcome.md)
- [List Call Outcomes](https://docs.oneinbox.ai/api-reference/workspace/list-call-outcomes.md)
- [Update Call Outcome](https://docs.oneinbox.ai/api-reference/workspace/update-call-outcome.md)
- [Agents](https://docs.oneinbox.ai/concepts/agents.md): An agent is the voice AI your callers talk to — it has a personality, a voice, and a set of actions it can take.
- [Authentication](https://docs.oneinbox.ai/concepts/authentication.md): How to authenticate API requests with your OneInbox API key.
- [How it works](https://docs.oneinbox.ai/concepts/how-it-works.md): What happens from the moment a call connects to the moment it ends — the full pipeline explained.
- [Integrations](https://docs.oneinbox.ai/concepts/integrations.md): Optionally store third-party provider keys in OneInbox (BYOK).
- [Web SDK](https://docs.oneinbox.ai/concepts/web-sdk.md): Let visitors talk to your AI agent directly from your website — no phone number, no app download.
- [Calls](https://docs.oneinbox.ai/guides/call-outcomes.md): Make outbound calls, receive inbound calls, read results, and manage call records. OneInbox automatically classifies outcomes after every call.
- [Knowledge Bases](https://docs.oneinbox.ai/guides/knowledge-bases.md): Upload your content — docs, FAQs, policies — so your agent can answer questions from it during calls.
- [LLMs](https://docs.oneinbox.ai/guides/llms.md): Configure the AI model that powers your agent's reasoning — set a system prompt, choose a provider, tune parameters, and attach tools.
- [Phone Numbers](https://docs.oneinbox.ai/guides/phone-calls.md): Search for, purchase, and register phone numbers with your telephony provider. To make calls, see [Calls](/guides/call-outcomes).
- [Quickstart](https://docs.oneinbox.ai/guides/quickstart.md): Build your first voice agent, get a phone number, and make a real call — no third-party telephony account required.
- [Tools](https://docs.oneinbox.ai/guides/tools.md): Give your agent the ability to take action during a call — send messages, capture data, transfer callers, book meetings, or call your own API.
- [Voices](https://docs.oneinbox.ai/guides/voices.md): OneInbox ships 28 ready-to-use voices across Cartesia, Deepgram, ElevenLabs, OpenAI, Minimax, and Shisa. Follow this guide if you want to use a specific custom voice from a third-party provider instead.
- [Webhooks](https://docs.oneinbox.ai/guides/webhooks.md): Receive real-time events from OneInbox on your server — no polling required.
- [Introduction](https://docs.oneinbox.ai/introduction.md): OneInbox is a voice orchestration platform for building AI agents that handle live phone and web conversations.

## OpenAPI Specs

- [openapi](https://docs.oneinbox.ai/openapi/openapi.yaml)