SMAO API Documentation
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_recording delete 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.

On this page