---
title: "Manage a browser session"
description: "Read and release 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.

# Manage a browser session

<p>Read a session to reconcile its durable status and usage. Session IDs are scoped to the application key; they are not public access tokens.</p>
<pre><code class="language-bash">curl "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"
</code></pre>
<p>List with <code>GET /v1/browsers/sessions?page=1&amp;size=20</code>. Release through a session update:</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>Release is idempotent. Disconnecting a CDP client does not prove that a keep-alive session ended; read it back and explicitly release it. View a running session using the URL returned by its debug endpoint, rather than constructing a console URL.</p>

Source: https://help.tooluse.net/browsers/getting-started/manage-browser-session/index.mdx