Sign in

v48

latestOpenAPI 3.0.0raw.githubusercontent.com2025-12-0297180624.8 KB
Browser

Update browser tab URL

Navigate an existing browser tab to a new URL. This endpoint updates the specified tab by navigating it to the provided URL and returns the updated tab information. The browser will wait for the DOM content to be loaded before returning the response. If the navigation fails due to an invalid URL or network issues, an error will be returned. The updated tab information will include the new title, final URL (after any redirects), and favicon from the new page.

put/boxes/{boxId}/browser/tabs/{tabId}

Path parameters

boxIdstring required
Example:c9bdc193-b54b-4ddb-a035-5ac0c598d32d

Box ID

tabIdstring required

Request body

urlstring required

The tab new url

Example request

{
  "url": "https://www.google.com"
}

Response

Successfully updated tab

idstring required

The tab id

titlestring required

The tab title

urlstring required

The tab url

faviconstring required

The tab favicon

activeboolean required

Whether the tab is the current active (frontmost) tab

loadingboolean required

Whether the tab is currently in a loading state.

The value is true while the browser is still navigating to the target URL or fetching sub-resources (i.e. document.readyState is not "complete"). It typically switches to false once the load event fires and all major network activity has settled.

Example response

{
  "id": "1",
  "title": "Google",
  "url": "https://www.google.com",
  "favicon": "https://www.google.com/favicon.ico",
  "active": true
}