Read call evidence

Every call — trial or production — attaches evidence to the session. An agent reads it back with the call and recording tools.

The evidence tools

→ list_calls(...)                        # calls:read
→ get_call(call_id="cl_...")             # calls:read — status + recording state
→ get_call_recording(call_id="cl_...")   # recordings:read — metadata + disclosure
→ get_call_transcript(call_id="cl_...")  # recordings:read — transcript turns

What a recording contains

A recording is the call's audio metadata plus:

• Waveform peaks — for rendering a scrubbable waveform.
• Transcript turns — speaker-attributed turns of the conversation.
• Retention / disclosure state — how long the audio is kept and whether the required call disclosure was made.

get_call returns the call status and recording state; get_call_recording returns recording metadata and disclosure state; get_call_transcript returns the transcript turns. Recording reads require the recordings:read scope, which is distinct from calls:read so you can grant transcript access without call metadata, or vice versa.