---
title: "Downloads"
description: "Retrieve browser downloads."
---

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

# Downloads

<p>List retained download metadata through the authenticated native endpoint. Use the session ID to scope the query.</p>
<pre><code class="language-bash">curl "https://api.tooluse.net/v1/browsers/downloads?sessionId=$SESSION_ID&amp;page=1&amp;size=20" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"
</code></pre>
<p>Read <code>GET /v1/browsers/downloads/{id}</code> for metadata. Request the same resource with <code>Accept: application/octet-stream</code> to stream the authenticated bytes. There is no public signed download URL.</p>
<p>Committed private-R2 files can survive browser shutdown when the deployment enables that storage. Expired, deleted, uncommitted or quota-refused files are not available indefinitely. Use the returned retention and state information, and delete a retained file with <code>DELETE /v1/browsers/downloads/{id}</code> when it is no longer needed. The Cloudflare Containers transport currently refuses downloads.</p>

Source: https://help.tooluse.net/browsers/files/downloads/index.mdx