---
title: "Update browser tab URL"
method: PUT
path: "/boxes/{boxId}/browser/tabs/{tabId}"
tags: ["Browser"]
---

# Update browser tab URL

`PUT /boxes/{boxId}/browser/tabs/{tabId}`

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.

## Path parameters

- `boxId` string, required
- `tabId` string, required

## Request body

- UpdateTab — Update tab url
  - `url` string, required — The tab new url

## Response `200`

Successfully updated tab

- BrowserTab — Browser tab
  - `id` string, required — The tab id
  - `title` string, required — The tab title
  - `url` string, required — The tab url
  - `favicon` string, required — The tab favicon
  - `active` boolean, required — Whether the tab is the current active (frontmost) tab
  - `loading` boolean, 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.

---

[API](https://skmtc.dev/babelcloud/apis/gbox-open-api.md) · [All operations](https://skmtc.dev/babelcloud/apis/gbox-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/babelcloud/gbox-open-api/revisions/d655577fa915/schema)