Documentation Index
Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt
Use this file to discover all available pages before exploring further.
Retrieve a presigned URL for a call recording. Wrapped by the Python SDK and Node SDK.
Endpoints at a glance
| Method | Path | Summary |
|---|
GET | /api/v1/sessions/{id}/recording | Get a presigned URL for the call recording |
Reference
GET /api/v1/sessions/{id}/recording
Get a presigned URL for the call recording
Returns a short-lived presigned S3 URL for playback. The URL expires in 5 minutes — refetch if it lapses. Returns 404 if no recording exists, 409 if the recording is not yet uploaded.
Parameters
| Name | In | Type | Required | Description |
|---|
id | path | string | Yes | Session id |
Responses
| Code | Description | Body |
|---|
200 | OK | object |
400 | Missing X-Account-ID header | string |
404 | No recording for this session | string |
409 | Recording not ready | string |
500 | Internal error | string |
503 | Recording playback not configured | string |
Example
curl https://api.kataven.ai/v1/sessions/agent_01HZ2N.../recording \
-H "Authorization: Bearer $KATAVEN_API_KEY"