---
title: "Recording downloads"
description: "Create a recording download."
---

> 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.

# Recording downloads

<p>Recording must have been enabled at creation, and the session must have ended with retained replay frames. Read the replay list to obtain a page ID.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID/recording/downloads" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pageId":"REPLACE_WITH_RETAINED_PAGE_ID"}'
</code></pre>
<p>The native request creates or reconciles one asynchronous MP4 job for that page. Read <code>GET /v1/browsers/sessions/{id}/recording/downloads</code> for jobs and status. Request <code>GET /v1/browsers/sessions/{id}/recording/downloads/{recordingId}</code> with <code>Accept: video/mp4</code> to stream authenticated completed bytes. A pending job is not a completed recording.</p>
<p>The deployment’s encoder, storage, quota and settlement requirements apply. There is no signed public recording URL. Retained source frames expire after 24 hours; request finalization while they are available.</p>

Source: https://help.tooluse.net/browsers/observability/recording-downloads/index.mdx