Recordings

Access to video call recordings. Recordings are stored in WebM format and become available after the call is completed.

Endpoints

Method	Endpoint	Description	Minimum Role
GET	/api/v1/calls/:call_id/recording	Get recording for a call	attendant

---

Get Recording

Returns the metadata and download URL for a call's recording.

GET /api/v1/calls/:call_id/recording

Path Parameters

Parameter	Type	Description
call_id	uuid	Call ID

Request Example

curl -X GET https://voki.avanter.com.br/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Success Response (200)

{
  "data": {
    "id": "r1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "call_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "format": "webm",
    "duration": 345,
    "file_size": 15234567,
    "download_url": "/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording/download",
    "transcription": {
      "status": "completed",
      "text": "Transcribed call text...",
      "language": "pt-BR"
    },
    "created_at": "2026-02-15T14:36:00Z"
  }
}

Errors

Code	Description
404	Call not found or has no recording
403	No permission to access the recording

{
  "errors": {
    "detail": "Recording not found"
  }
}

---

Technical Notes

Recording Format

Recordings are saved in WebM format (VP8/Opus) by the native Elixir/Rust SFU. The file contains:

• Video: All participants in a composite layout
• Audio: Mix of all participants

Transcription

If transcription is enabled in the company settings (transcription_enabled: true), the audio is processed by the voki_ai module to generate automatic transcription via Whisper.

Storage

• Recordings are stored locally on the server
• Retention period depends on the subscribed plan
• Recordings cannot be deleted individually (auditability policy)

Auditability Policy

Departments that have calls with recordings cannot be deleted. This ensures traceability and regulatory compliance of recordings.