---
title: "Using a browser session"
description: "Control a running session."
---

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

# Using a browser session

<p>Read the created session and use its returned <code>connectUrl</code> with a compatible Chromium CDP client. Keep connection URLs private. You can also use bounded native HTTP actions without a browser SDK.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID/actions" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Idempotency-Key: tooluse-example-001" \
  -H "Content-Type: application/json" \
  -d '{"action":{"kind":"navigate","url":"https://example.com"}}'
</code></pre>
<p>An action returns an observation. Use that observation’s ID and element references for later click, fill or select actions. A stale reference returns <code>409 stale_observation</code>. Password, card and file input fields are refused by ordinary fill actions. Human checks return an awaiting-user state; use a handoff instead of bypassing the check.</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>

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