Long sessions | Tooluse.net Help

Set a finite top-level timeout in seconds at creation. It defaults to 3600 and must be between 60 and 21600. A session cannot extend beyond its admitted lifetime.

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":600,"keepAlive":true}'

keepAlive permits a supported session to survive CDP disconnects; it does not make a session unlimited or free. Read state before reconnecting and release when finished.

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"}'