Browser Bridge

Open a browser session. Accepts a paired bridge credential only — an agent token is refused, so a session cannot be bootstrapped on an unpaired machine.

post/v1/agents/{id}/browser/sessions

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{id}/browser/sessions
  • Auth: HTTP bearer

Headers

x-1claw-bridge-credentialstring required

The bb_ credential from 1claw browser-bridge login

x-1claw-bridge-versionstring required

Bridge build. Versions below the server minimum are refused.

Request body

agent_idstring uuid required

Must belong to the same org as the paired device.

client_idstring required
bridge_versionstring
protocol_versionstring

Response

Session created

session_idstring uuid
session_tokenstring

bs_ prefixed. Only its hash is stored.

expires_atstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.