---
title: "Navigate a tab to a URL or macro"
method: POST
path: "/tabs/{tabId}/navigate"
tags: ["Navigation"]
---

# Navigate a tab to a URL or macro

`POST /tabs/{tabId}/navigate`

Navigate to a URL or expand a search macro. Auto-creates tab if not found.

## Path parameters

- `tabId` string, required

## Request body

- object
  - `userId` string, required
  - `url` string
  - `macro` string — Search macro (e.g. @google_search).
  - `query` string — Search query for macro.
  - `sessionKey` string
  - `listItemId` string

## Response `200`

Navigation result with snapshot.

- object

## Other responses

- `400` — Bad request.
- `404` — Tab not found.

---

[API](https://skmtc.dev/jo-inc/apis/camofox-browser.md) · [All operations](https://skmtc.dev/jo-inc/apis/camofox-browser/llms.txt) · [OpenAPI document](https://skmtc.dev/jo-inc/apis/camofox-browser/revisions/124530649075?raw)