---
title: "Open a new browser tab"
method: POST
path: "/boxes/{boxId}/browser/tabs"
tags: ["Browser"]
---

# Open a new browser tab

`POST /boxes/{boxId}/browser/tabs`

Create and open a new browser tab with the specified URL. This endpoint will navigate to the provided URL and return the new tab's information including its assigned id, loaded title, final URL (after any redirects), and favicon. The returned tab id can be used for future operations on this specific tab. The browser will attempt to load the page and will wait for the DOM content to be loaded before returning the response. If the URL is invalid or unreachable, an error will be returned.

## Path parameters

- `boxId` string, required

## Request body

- OpenTab — Open tab
  - `url` string, required — The tab url

## Response `200`

Successfully opened new 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)
