---
title: "Timeout"
description: "Session timeouts."
---

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

# Timeout

<p>Use top-level <code>timeout</code> for the maximum session lifetime in seconds. Accepted values are 60 through 21600; the default is 3600. The legacy <code>timeoutSeconds</code> alias must agree if both are supplied.</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}'
</code></pre>
<p>The timeout is a creation setting, not a heartbeat or an unlimited extension. Read durable session state after disconnects. Use an explicit release to finish early; do not wait for the timeout when the work is already done.</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/long-sessions/timeouts/index.mdx