/chromium/agent
GET/chromium/agent
WebSocket endpoint for agentic browser interaction. Connect to establish a persistent browser session, then send JSON-RPC messages to control the browser.
Uses a simple JSON protocol instead of GraphQL: Send: { "id": 1, "method": "goto", "params": { "url": "https://example.com" } } Receive: { "id": 1, "result": { "status": 200, "url": "https://example.com" } }
All BQL mutations are available as methods (goto, click, type, screenshot, etc.). Additionally supports a "snapshot" method that returns interactive page elements with CSS selectors, plus tab-management methods (getTabs, switchTab, createTab, closeTab) for multi-tab workflows.
Request
Responses
- 101
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
Indicates successful WebSocket upgrade.
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.