curl https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio \
-H "Authorization: Bearer sk_live_your_api_key" \
-o recording.mp3
import fs from 'fs';
const response = await fetch('https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio', {
headers: {
'Authorization': 'Bearer sk_live_your_api_key'
}
});
const buffer = await response.arrayBuffer();
fs.writeFileSync('recording.mp3', Buffer.from(buffer));
import requests
response = requests.get(
'https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio',
headers={'Authorization': 'Bearer sk_live_your_api_key'}
)
response.raise_for_status()
with open('recording.mp3', 'wb') as f:
f.write(response.content)
HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 1048576
Content-Disposition: attachment; filename="recording-sess_01HXYZ123456789.mp3"
[binary audio data]
{
"error": {
"code": "recording_not_found",
"message": "No recording found with ID 'rec_01HABC987654321'.",
"type": "not_found_error"
}
}
Recordings
Download Recording
Download the audio file for a recording
GET
/
v1
/
recordings
/
{recording_id}
/
audio
curl https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio \
-H "Authorization: Bearer sk_live_your_api_key" \
-o recording.mp3
import fs from 'fs';
const response = await fetch('https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio', {
headers: {
'Authorization': 'Bearer sk_live_your_api_key'
}
});
const buffer = await response.arrayBuffer();
fs.writeFileSync('recording.mp3', Buffer.from(buffer));
import requests
response = requests.get(
'https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio',
headers={'Authorization': 'Bearer sk_live_your_api_key'}
)
response.raise_for_status()
with open('recording.mp3', 'wb') as f:
f.write(response.content)
HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 1048576
Content-Disposition: attachment; filename="recording-sess_01HXYZ123456789.mp3"
[binary audio data]
{
"error": {
"code": "recording_not_found",
"message": "No recording found with ID 'rec_01HABC987654321'.",
"type": "not_found_error"
}
}
Download the audio file for a recording. This endpoint streams the audio bytes directly.
Path Parameters
The unique recording identifier (e.g.,
rec_01HABC987654321).Response
Returns the audio file as a binary stream.Headers
| Header | Description |
|---|---|
Content-Type | audio/mpeg for MP3 files |
Content-Length | File size in bytes |
Content-Disposition | Filename suggestion |
curl https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio \
-H "Authorization: Bearer sk_live_your_api_key" \
-o recording.mp3
import fs from 'fs';
const response = await fetch('https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio', {
headers: {
'Authorization': 'Bearer sk_live_your_api_key'
}
});
const buffer = await response.arrayBuffer();
fs.writeFileSync('recording.mp3', Buffer.from(buffer));
import requests
response = requests.get(
'https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio',
headers={'Authorization': 'Bearer sk_live_your_api_key'}
)
response.raise_for_status()
with open('recording.mp3', 'wb') as f:
f.write(response.content)
HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 1048576
Content-Disposition: attachment; filename="recording-sess_01HXYZ123456789.mp3"
[binary audio data]
{
"error": {
"code": "recording_not_found",
"message": "No recording found with ID 'rec_01HABC987654321'.",
"type": "not_found_error"
}
}
Streaming Downloads
For large recordings, you can stream the download instead of buffering the entire file:import { createWriteStream } from 'fs';
import { pipeline } from 'stream/promises';
const response = await fetch('https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio', {
headers: {
'Authorization': 'Bearer sk_live_your_api_key'
}
});
await pipeline(
response.body,
createWriteStream('recording.mp3')
);
import requests
with requests.get(
'https://api.kallglot.com/v1/recordings/rec_01HABC987654321/audio',
headers={'Authorization': 'Bearer sk_live_your_api_key'},
stream=True
) as r:
r.raise_for_status()
with open('recording.mp3', 'wb') as f:
for chunk in r.iter_content(chunk_size=8192):
f.write(chunk)
Notes
Recordings are returned in MP3 format. The original audio is 8kHz mono (telephony quality).
⌘I