LiveKit Community

what is the record - boolean key in the agent session

Thanks for reaching out, Mohammed. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.


Thanks — you're asking about the `record` boolean key in an agent session.

• *What it does:* `record` controls whether Agent Observability data for that session is recorded (traces, logs, and audio).
• *Default / behavior:* Recording is enabled by default (or if omitted). Set `record: False` to prevent any observability data from being saved for that session.
• *Where it applies:* This affects Agent Insights in LiveKit Cloud only (not self-hosted servers).
• *Project setting required:* Recording must also be enabled in the project’s Data and privacy settings for `record` to take effect.
• *Selective recording (Python SDK ≥ 1.4.2):* `record` can be a dictionary to enable/disable specific items (audio, traces, logs, transcripts). Example:
```
await session.start({
  record=False  # disables recording for this session
})
```
• *Delay to appear:* Observability data may take up to ~5 minutes to show in the dashboard after a session ends.
If you want, tell me which SDK/language and LiveKit SDK version you're using and I can show the exact session-start example for your setup.
 Sources: <https://livekit.com/blog/streamline-troubleshooting-with-agent-observability/|Streamline troubleshooting with Agent Observability | LiveKit> | <https://livekit.com/blog/no-observability-data-available|Why is my Agent insights data missing? | LiveKit>, with interactive elements