---
title: "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."
method: POST
path: "/v1/agents/{id}/browser/sessions"
tags: ["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-credential` string, required
- `x-1claw-bridge-version` string, required

## Request body

- object
  - `agent_id` string, uuid, required: Must belong to the same org as the paired device.
  - `client_id` string, required
  - `bridge_version` string
  - `protocol_version` string

## Response `200`

Session created

- object
  - `session_id` string, uuid
  - `session_token` string: bs_ prefixed. Only its hash is stored.
  - `expires_at` string, date-time

## Other responses

- `400`: Missing or unsupported bridge version
- `401`: Not a paired bridge, or an agent token was presented
- `403`: The device and the agent are not in the same org

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)