ConvoStack
ConvoStack is the Meldcore AI voice platform. It handles real-time spoken conversation — speech in, speech out — including streaming transcription, turn taking, and voice synthesis, driven by agents you configure through this API.
ConvoStack is voice only. It is the ai_voice capability, not a general
conversation brain: reasoning, decisions and knowledge live behind the
control plane, and ConvoStack consumes those capabilities rather than
implementing them. If you are looking for prompt logic or agent reasoning,
you are in the wrong service.
Quick start
# Create an agent and get it live in two calls
curl -X POST https://convostack.ai/api/agents \
-H "Authorization: Bearer cak_live_..." \
-H "Content-Type: application/json" \
-d '{"name": "Support Bot", "firstMessage": "Hi, how can I help?"}'
curl -X POST https://convostack.ai/api/agents/{id}/publish \
-H "Authorization: Bearer cak_live_..."
No cak_live_... key yet? See Authentication — it
takes about a minute from the dashboard.
What's in these docs
| Section | What it covers |
|---|---|
| Getting started | Reaching the service, authenticating, making your first call |
| Authentication | Generating, using, and revoking API keys |
| Agents | The draft/publish model, presets, and tool binding |
| Calls & campaigns | Placing calls one at a time or in bulk |
| Phone numbers | Managing the numbers your org owns |
| Voices | The voice catalog and bringing your own TTS provider keys |
| Workflows | Structured, step-driven conversations |
| Credits & billing | Checking balance, budgets, plans, and invoices |
| Webhooks | Getting a summary pushed to you after each call |
| Connectors | Connecting agent tools to external systems |
| Knowledge | Uploading documents an agent can ground answers in |
| Dashboard | An org-scoped snapshot: active calls, today's volume, latency |
| Analytics | Call volume, latency, and estimated spend over time |
| Notifications | Reading and marking account-level notifications |
| STT | The speech-to-text provider catalog |
| Tool catalog | The structured schema for every tool kind an agent can bind |
| Errors | The error response shape and status codes |
| Rate limits | Per-org throttling, especially on call-placing endpoints |
| API Reference | Every endpoint, generated from the OpenAPI document |
Where this fits
ConvoStack is one part of the Meldcore product family, so if you've integrated against another Meldcore application before, the authentication and organization model here will already be familiar.
The runtime architecture (ASR → turn taking → TTS) isn't part of this public reference yet — everything you need to build against ConvoStack (auth, agents, calls, workflows) is covered in the sections above; the internal streaming pipeline is documented separately as it stabilizes.