Reload
Browser Sessions
Reload
Reload the active tab, optionally bypassing the HTTP cache.
POST
Reload
Overview
The/browser/sessions/{id}/reload endpoint reloads the currently active tab. By default the reload reuses the HTTP cache; pass ignoreCache: true to force a full re-fetch of all resources.
The call blocks until the configured wait condition is met or the timeout elapses.
Path Parameters
string
required
Browser session ID (UUID). Create via
POST /browser/sessions.Body
All body fields are optional — the request body may be omitted entirely.boolean
default:"false"
When
true, bypasses the HTTP cache (equivalent to Ctrl+Shift+R). Re-fetches all resources from origin.string
default:"load"
When to consider the reload finished. One of
load, domcontentloaded, networkidle.integer
default:"30000"
Maximum time (ms) to wait for the reload to complete. Range
0–120000.Example Request
Response
Success Response (200)
string
Effective URL of the active tab after reload.
string
CDP target identifier of the tab the reload applied to.
Error Responses
Notes
ignoreCache: trueis equivalent toCtrl+Shift+R— re-fetches all resources bypassing the HTTP cache.- The URL of the active tab is preserved across reloads; only the document and its subresources are refetched.