Skip to content

Core features

Updated View as Markdown

Choose viewport, timeout, metadata, recording and domain restrictions when creating a session. A capability that the selected transport cannot provide returns an explicit refusal.

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

Use the returned connection URL with a compatible CDP client, or call the native HTTP actions API. Context persistence depends on encrypted storage being configured. Extensions and uploaded certificate authorities are not available.

See Create a browser session and the Browsers API for authentication, request fields, and limits.

Type to search…

↑↓ navigate↵ selectEsc close