Skip to main content

Download Live Recording

GET 

https://api.knox.chat/v1/live/sessions/:session_id/content

Download the stored recording for a Live session created with "store": true. The file is a stereo WAV: caller input on the left channel, assistant output on the right.

Recordings are available for 30 days after create. Only the session owner can download. See the GPT-Live guide.

Request​

Path Parameters​

NameTypeRequiredDescription
session_idStringYesStored Live session id.

Request Headers​

NameTypeRequiredDescription
AuthorizationStringYesBearer sk-….

cURL example​

curl -L https://api.knox.chat/v1/live/sessions/sess_…/content \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-o session.wav

Response​

200 with Content-Type: audio/wav (or the upstream type) and Content-Disposition: attachment; filename="{session_id}.wav". The body is streamed.

Error Responses​

StatusWhen
401Missing or invalid Knox API key.
403Token is not authorized for gpt-live-1.
404Session not found, not owned by you, not stored (store: false), or older than 30 days.
502Failed to fetch the recording from the Live provider.