---
title: "Browsers"
description: "Cloud browser sessions."
---

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

# Browsers

<p>Tooluse.net runs cloud Chromium sessions that you control through HTTP actions or a returned CDP connection. Each session belongs to the authenticated application.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Idempotency-Key: tooluse-example-001" \
  -H "Content-Type: application/json" \
  -d '{"timeout":300,"browserSettings":{"viewport":{"width":1280,"height":720}}}'
</code></pre>
<p>Store the returned <code>id</code> as <code>SESSION_ID</code>. Read it to reconcile an uncertain create result; reuse the same idempotency key only for the same intended request. Release the session when finished.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"REQUEST_RELEASE"}'
</code></pre>
<p>See <a href="/browsers/getting-started/create-browser-session">Create a browser session</a> and the <a href="/browsers/api">Browsers API</a> for authentication, request fields, and limits.</p>

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