Skip to main content
LLM ReadyRaw Markdown for AI agents:recordings.mdFull index:llms.txtllms-full.txt

Recordings & Transcriptions

Manage call recordings and AI transcriptions stored in your workspace. Use these endpoints to fetch playable media, archive files to your own storage, and permanently delete recordings or transcriptions according to your company's data retention policy.

All endpoints require ApiKey authentication:

Authorization: ApiKey sk-YOUR_API_KEY
MethodEndpointDescription
GET/calls/:id/recordingsList all recordings of a call with presigned stream/download URLs
GET/calls/:id/recordings/streamStream the primary (first) recording of a call
GET/calls/:id/recordings/:index/streamStream a recording by index
GET/calls/:id/recordings/:index/downloadDownload a recording file (302 redirect or JSON)
DELETE/calls/:id/recordingsDelete all recordings of a call
DELETE/calls/:id/recordings/:recording_idDelete a single recording
GET/recordingsList all recordings in the workspace (paginated, filterable)
DELETE/recordings/bulkBulk delete up to 100 recordings by ID
GET/calls/:id/transcriptionGet the transcription of a call
DELETE/calls/:id/transcriptionDelete the transcription of a call
GET/transcriptionsList all transcriptions in the workspace (paginated, filterable)
DELETE/transcriptions/bulkBulk delete up to 100 transcriptions by ID

:::info Presigned URLs Recording files are stored privately on S3. The stream_url, download_url and the url delivered in the call.recording.ready webhook are presigned, time-limited URLs — they cannot be accessed publicly and expire 2 hours after they are issued.

Download the file as soon as you receive the webhook. If a URL has expired, call GET /calls/:id/recordings to obtain fresh URLs. :::


List Recordings of a Call​

GET /calls/:id/recordings

Example Request​

curl -X GET "https://{workspace_id}.firetell.app/api/v1/calls/call_01h900000000000000000001/recordings" \
-H "Authorization: ApiKey sk-YOUR_API_KEY"

Response 200 OK​

{
"call_id": "call_01h900000000000000000001",
"recordings": [
{
"index": 0,
"id": "rec_01h900000000000000000001",
"start_time": "2026-08-17T11:01:11.035Z",
"end_time": "2026-08-17T11:01:27.163Z",
"duration": 16,
"format": "wav",
"size_bytes": 256000,
"file": "https://firetell-asia-south1.s3.amazonaws.com/yourcompany/recordings/call_01h.../rec.wav",
"stream_url": "https://firetell-asia-south1.s3.amazonaws.com/yourcompany/recordings/call_01h.../rec.wav?X-Amz-Signature=...",
"download_url": "https://firetell-asia-south1.s3.amazonaws.com/yourcompany/recordings/call_01h.../rec.wav?response-content-disposition=attachment..."
}
]
}

Download a Recording​

GET /calls/:id/recordings/:index/download
Query ParameterTypeDefaultDescription
redirectbooleantrueWhen true, responds 302 to the presigned download URL. When false, returns JSON metadata.
curl -L -o recording.wav \
"https://{workspace_id}.firetell.app/api/v1/calls/call_01h900000000000000000001/recordings/0/download" \
-H "Authorization: ApiKey sk-YOUR_API_KEY"

Delete Recordings​

Deletion is permanent: audio files are removed from cloud storage and cannot be recovered. Call metadata (CDR: time, duration, cost, status) is preserved for billing and audit purposes.

Delete a single recording​

DELETE /calls/:id/recordings/:recording_id
curl -X DELETE "https://{workspace_id}.firetell.app/api/v1/calls/call_01h900000000000000000001/recordings/rec_01h900000000000000000001" \
-H "Authorization: ApiKey sk-YOUR_API_KEY"
{
"message": "Recording deleted successfully",
"call_id": "call_01h900000000000000000001",
"recording_id": "rec_01h900000000000000000001",
"freed_bytes": 256000,
"remaining_recordings": 0
}

Delete all recordings of a call​

DELETE /calls/:id/recordings
{
"message": "Call recordings deleted successfully",
"call_id": "call_01h900000000000000000001",
"deleted_count": 1,
"freed_bytes": 256000
}

Bulk delete recordings​

DELETE /recordings/bulk
FieldTypeRequiredDescription
idsstring[]✅Recording IDs to delete (1–100 items)
curl -X DELETE "https://{workspace_id}.firetell.app/api/v1/recordings/bulk" \
-H "Authorization: ApiKey sk-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "ids": ["rec_01h900000000000000000001", "rec_01h900000000000000000002"] }'
{
"message": "Recordings deleted successfully",
"deleted_count": 2,
"freed_bytes": 512000
}

List Workspace Recordings​

GET /recordings
Query ParameterTypeDescription
call_idstringFilter by call ID
fromstringStart of date range (ISO 8601)
tostringEnd of date range (ISO 8601)
searchstringText search
pagenumberPage number (default 1)
limitnumberItems per page (default 20)
sort_fieldstringSort field
sort_orderstringasc or desc

Transcriptions​

Get the transcription of a call​

GET /calls/:id/transcription

Returns the dialogue timeline (speaker, channel, confidence, timestamps), the full text and AI metadata.

Delete the transcription of a call​

DELETE /calls/:id/transcription
{
"message": "Call transcription deleted successfully",
"call_id": "call_01h900000000000000000001"
}

Bulk delete transcriptions​

DELETE /transcriptions/bulk
curl -X DELETE "https://{workspace_id}.firetell.app/api/v1/transcriptions/bulk" \
-H "Authorization: ApiKey sk-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "ids": ["trans_01h900000000000000000001", "trans_01h900000000000000000002"] }'

Zero-Retention Workflow​

Combine webhooks with the delete endpoints to keep recordings only in storage you control:

  1. Subscribe to the call.recording.ready webhook.
  2. When it arrives, verify the X-Webhook-Signature and immediately download the file from the presigned url.
  3. Store the file in your own S3/GCS bucket, data warehouse or on-premise storage.
  4. Call DELETE /calls/:id/recordings/:recording_id (and DELETE /calls/:id/transcription if needed) according to your data retention policy.
app.post("/webhooks/firetell", async (req, res) => {
// verify X-Webhook-Signature first (see Webhooks overview)
const { event, data } = req.body;

if (event === "call.recording.ready") {
// data.url is presigned and expires after 2 hours: download right away
const audio = await fetch(data.url).then((r) => r.arrayBuffer());
await archiveToPrivateStorage(`recordings/${data.call_id}.${data.format}`, audio);

// Delete the cloud copy per your retention policy
await fetch(
`https://${WORKSPACE_ID}.firetell.app/api/v1/calls/${data.call_id}/recordings/${data.recording_id}`,
{ method: "DELETE", headers: { Authorization: `ApiKey ${process.env.FIRETELL_API_KEY}` } },
);
}

res.status(200).send("OK");
});