---
title: "Session replay"
description: "Read retained replay frames."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Session replay

<p>Enable recording at session creation with <code>browserSettings.recordSession:true</code>. Recording must be supported by the configured transport; otherwise the service returns an explicit refusal.</p>
<pre><code class="language-bash">curl "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID/replays" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"
</code></pre>
<p>The native endpoint lists retained pages. Read <code>GET /v1/browsers/sessions/{id}/replays/{pageId}?page=1&amp;size=20</code> for paginated base64 JPEG frames. This native route is not an HLS playlist. Replay frames are retained for 24 hours, subject to the deployment’s recorder availability and bounded storage.</p>
<p>To obtain an MP4 after a recorded session ends, use <a href="/browsers/observability/recording-downloads">recording downloads</a>.</p>

Source: https://help.tooluse.net/browsers/observability/session-replay/index.mdx