SMAO API Documentation
Public APICalls & recordings

Download the call recording

GET
/calls/{call_id}/recording

Returns the audio recording as a binary stream. Supports HTTP Range for partial content. Returns 404 with JSON envelope when no recording exists for the call.

Authorization

bearerAuth
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Path Parameters

call_id*string
Match^[a-f0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/calls/65f8fa6f1a9d8e0012ab34cd/recording"
"string"

Get a call with transcript, analyses, and notes GET

Get a call with transcript, analyses, and notes

Permanently delete the call recording DELETE

**Irreversible.** Erases every audio artifact of the call from object storage — the master recording, both channel recordings, the playback transcode and the waveform data — and reports success only after the deletion has been verified. The call itself is kept: transcript, analyses, notes, metadata and diagnostics are untouched, and the call keeps appearing in `GET /calls`.