Kataven Hub API — call recordings - Kataven

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"

from kataven import KatavenClient

client = KatavenClient()  # reads KATAVEN_API_KEY
client.recordings.get(id="agent_01HZ2N...")

import { Kataven } from "@kataven/server";

const client = new Kataven();   // reads KATAVEN_API_KEY
await client.recordings.get("agent_01HZ2N...");