Getting Started
Introduction
What the OnCore Core API is and what you can build with it.
The OnCore Core API is the programmatic interface to the OnCore voice AI platform. Everything you can do in the OnCore dashboard — creating assistants, managing prompts and tools, buying phone numbers, reading call activity — is available over a REST API, plus embed channels (browser voice calls and web chat) and webhooks that push call results to your servers.
All requests go to a single base URL:
https://core-api.heysadie.aiEndpoints are served at the root path — there is no /v1 prefix, with one exception: the organization-level audit endpoints (/v1/retention/audits, /v1/churn/audits).
What you can build#
- Provision assistants programmatically — create and configure voice assistants, attach prompts, tools, knowledge-base documents, and task flows.
- Embed voice and chat in your product — start browser-based WebRTC voice calls or web-chat conversations with an assistant, no telephony required.
- Sync call outcomes to your systems — receive an end-of-call report webhook with transcript, summary, recording, and structured data after every call.
- Automate phone number management — search, purchase, and configure inbound numbers with failover.
API at a glance#
| Area | Resources |
|---|---|
| Build | Assistants, prompts, tools, documents, task groups |
| Telephony | Phone numbers, transfer reasons, SMS reasons |
| Activity | Calls (read-only), conversations (read-only), exports |
| Embed | Web chat sessions, WebRTC calls |
| Events | End-of-call reports, assistant requests, tool calls |
Interactive API explorer#
The live, always-current API specification is served by the API itself at https://core-api.heysadie.ai/swagger. Use it to browse every endpoint's full request/response schema and try calls directly from your browser (authorize with ApiKey YOUR_API_KEY).
First steps#
- Read the Quickstart — first authenticated request in under five minutes.
- Understand Authentication — tenant keys, organization keys, and headers.
- Explore the API Reference for full endpoint details.
Your API key is already waiting for you on the API Keys page of your OnCore dashboard.