end_browser - kubed-io/selenium-flow GitHub Wiki

end_browser

Quit the browser, keeping the workspace and its context.

MCP tool end_browser
HTTP DELETE /browser

Quit this workspace's browser and free its Grid slot.

Call it when finished, and on failure paths too: browsers are scarce, and an abandoned one holds its slot until the Grid reaps it. The workspace survives, so a later open_session() comes back to the same page. Files the browser had and you did not keep go with it.

Parameters

This action takes no parameters.

Every call names its workspace: an X-Workspace header, or ?workspace=<name>. Sending both is refused. See Workspaces.

Returns

Field Type Notes
success boolean
workspace string

Errors

Status Means
400 The request cannot succeed as sent — no workspace named, two names given, or a setting that was rejected.
401 Missing or wrong bearer token.
413 The body is over its cap: 1 MiB of JSON, 64 MiB of upload, 1 MiB of flow YAML. Send less; retrying it unchanged will fail again.
503 The Grid could not serve this — unreachable, or no free slot for a new browser. Worth retrying after a wait.

Over MCP the same failures arrive as a tool error.

Example

MCP

end_browser()

HTTP

curl -X DELETE $SELENIUM_FLOW/browser \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Workspace: $WORKSPACE"

← All actions · Installing · Deployment

⚠️ **GitHub.com Fallback** ⚠️