---
title: "Issue one browse op (agent side)"
method: POST
path: "/api/v1/browse-local/{sessionId}/op"
tags: ["Runs"]
---

# Issue one browse op (agent side)

`POST /api/v1/browse-local/{sessionId}/op`

## Request

- Base URL: `https://unbrowse.ai`
- URL: `https://unbrowse.ai/api/v1/browse-local/{sessionId}/op`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://unbrowse.ai/authorize`, token URL `https://unbrowse.ai/oauth/token`, scopes: `unbrowse`)
  - HTTP bearer

open / snapshot / act / finish. Blocks until the connected CLI runs it in the local browser and returns the result; finish returns the learned (private) tool.

## Path parameters

- `sessionId` string, required

## Request body

- object
  - `op` 'open' | 'snapshot' | 'act' | 'finish', required
  - `url` string
  - `ref` string
  - `action` string
  - `value` string
  - `title` string

## Response `200`

The op result

- Object

## Other responses

- `400`: An error
- `401`: Missing or invalid credentials. The WWW-Authenticate header names the protected-resource metadata.
- `402`: An error
- `404`: An error
- `429`: An error

---

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