Skip to content
brow

HTTP API

The brow daemon exposes a REST API on http://127.0.0.1:19987. All request and response bodies are JSON.

Base URL

http://127.0.0.1:19987

Configurable via BROW_PORT environment variable.

Interactive docs

The daemon serves OpenAPI docs at:

  • Swagger UI: http://127.0.0.1:19987/docs
  • ReDoc: http://127.0.0.1:19987/redoc
  • OpenAPI JSON: http://127.0.0.1:19987/openapi.json

Error responses

All errors follow FastAPI’s standard format:

{"detail": "Session 5 not found"}
HTTP StatusMeaning
400Invalid request body
404Session, selector, or resource not found
408Eval timeout
502Browser error (navigation failed, selector timeout)

Sections

SectionPrefixDescription
Sessions/sessionsCreate and manage browser sessions
Browser Actions/browser/{sid}Navigate, click, fill, inspect
Pages/pages/{sid}Multi-tab management
Profiles & States/profiles, /statesLogin persistence
Eval/eval/{sid}Execute arbitrary Python

Health check

GET /status
{"status": "running", "sessions": 2}