API Overview
Programmatic access to the Tandem platform over HTTPS.
The Tandem API lets you build on the platform programmatically: manage workflows, media, integrations, phone numbers, and messaging directly from your own services.
Base URL
All requests are made over HTTPS to the base URL for your environment:
https://api.tandemcx.ai
The API answers at both api.tandemcx.ai and api.spark.sharpencx.com (in development,
api.develop.tandemcx.ai and api.develop.spark.sharpencx.com). Both hosts serve the same API
and accept the same tokens, so you can use either.
Request and response format
Requests and responses use JSON. Send Content-Type: application/json on any
request with a body. Responses are JSON unless otherwise noted (for example,
audio downloads return binary data).
Resources
The API is organized into resource groups. The Reference column says which ones have endpoint-by-endpoint documentation in this portal, generated from the service's own OpenAPI spec.
| Resource | Base path | Reference |
|---|---|---|
| Voice agents | /v1/agent-media | Voice Agents |
| Prompts (media) | /v1/media/prompts | Media |
| Text-to-speech | /v1/media/tts | Media |
| Phone numbers | /v1/routing/phone-numbers | Routing |
| Billing | /v1/billing | Billing |
| Contacts | /v1/contacts | Contacts |
| Workflows | /v1/workflows | Not yet documented |
| Integrations | /v1/integrations | Not yet documented |
| Knowledge bases | /v1/knowledge | Not yet documented |
/v1/email | Not yet documented | |
| Reporting | /v1/reporting | Not yet documented |
| Audit log | /v1/audit | Not yet documented |
| Users | /v1/accounts | Not yet documented |
| Secrets and variables | /v1/org-config | Not yet documented |
| SIP trunks | /v1/routing/sip-trunks | Not yet documented |
| Organization settings | /v1/settings | Not yet documented |
A group marked "not yet documented" is a live part of the API; it has no generated reference here yet. Contact support if you need its shapes before it lands.
Next steps
- Authentication — how to authorize requests.
- Pagination — how to page through list endpoints.
- Error Handling — the error format and status codes.