Public API
Changelog
Notable changes to the Public API.
1.1.0 — Recording erasure
- New
DELETE /calls/{call_id}/recording: permanently erases a call's audio — master recording, both channel recordings, the playback transcode and the waveform data — while keeping the call itself with its transcript, analyses and notes. Irreversible, and reported as successful only after the deletion has been verified in storage. - Requires a key whose role carries the new
call_logs.call_recordingdelete permission. Existing keys do not gain it implicitly — an organization admin grants it per role. - Erasing twice succeeds without changing anything. A call that is still running,
or whose recording is still being processed, answers
409.
1.0.0 — Initial public release
First stable release of the Public API at /api/v1:
- Assistants, prompts, knowledge items, contacts, and groups — full CRUD.
- Forwardings, glossary, pronunciation rules, calendars, and webhook tools.
- Call history with transcripts and analyses, recording download, and outbound call triggering.
- Read-only usage statistics (weekly/monthly, per-assistant, last-24h).
- Bearer-token auth with role-scoped keys, default per-key rate-limit buckets,
X-RateLimit-*headers on rate-limited operations, opaque cursor pagination, and a uniform{ "error": { "code", "message" } }envelope.
Documentation now lives at docs.smao.ai — the old
/api/v1/docs URLs redirect here.