How to read this page
- additive New endpoints, tools, fields or enum values. Clients must tolerate unknown fields and values, so these never need action.
- breaking A behaviour change. It ships under a new dated
VoixCall-Version; existing keys and connections stay pinned to the version they were created with until you upgrade them. The old version then getsDeprecationandSunsetheaders and, after the sunset date, answers 410version_sunsetwith a migration link.
Current API version: 2026-10-01. No version is deprecated.
Public API and MCP server, phase 1 additive
The first public surface on api.voixcall.com: an OAuth 2.1 authorization server, the /v1/me endpoint, an MCP server with one tool, API-key management endpoints and rate limiting.
- OAuth 2.1 authorization code flow with PKCE (S256) at https://api.voixcall.com/oauth/authorize and /oauth/token, with refresh-token rotation and RFC 7009 revocation at /oauth/revoke.
- Client registration by Client ID Metadata Document (an https client_id that serves its own metadata) and by Dynamic Client Registration at /oauth/register.
- Discovery: /.well-known/oauth-authorization-server and protected-resource metadata at /.well-known/oauth-protected-resource/v1 and /mcp.
- GET /v1/me returns the connected account (object, id, email, display_name, country_code, time_zone, livemode). OpenAPI 3.1 at https://api.voixcall.com/v1/openapi.json.
- MCP server at https://api.voixcall.com/mcp (Streamable HTTP, JSON responses, OAuth only) with the voixcall_whoami tool.
- Personal API keys (vc_live_ and vc_test_): management endpoints under /v1/api-keys for signed-in dashboard sessions. The Settings screen to create keys ships later.
- Rate limiting with RateLimit, RateLimit-Policy, X-RateLimit-* and Retry-After headers on rate-limited public responses.
- Error envelope with type, code, message, param, doc_url and request_id; every doc_url points at https://voixcall.com/developers/errors.
- VoixCall-Version header (current version 2026-10-01) echoed on every /v1 response.
- Settings โ Connected apps in the web app lists connected assistants and lets you disconnect them.