resize

resize

Resize the browser window.

MCP tool	resize
HTTP	POST /browser/resize

Use this when layout matters and the browser was opened for you, or when you need a different size partway through. The headless default is small and varies between Grid nodes, so set it explicitly before judging anything visual.

Parameters

Name	Type	Required	Default	Notes
width	integer	no	—
height	integer	no	—
session_id	string	yes over HTTP	—	The session_id returned by /browser/open. Required here.

Returns

Field	Type	Notes
width	integer	Window width now in effect.
height	integer	Window height now in effect.
url	string	Current URL after the action.
title	string	Page title after the action.

Errors are 400 for a bad argument, 401 without a token, 500 when the Grid refuses. Over MCP the same failures arrive as a tool error.

Example

MCP

resize()

HTTP

curl -X POST $SELENIUM_FLOW/browser/resize \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "session_id": "…"
  }'

---

← All actions · Installing · Deployment