API Reference

Computers

Tabs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Switch to tab

computers.tabs.switch(strtab_id, TabSwitchParams**kwargs) -> ActionResult

POST/computers/{id}/tabs/{tab_id}/switch

Switch the main/active tab to a different tab by ID (browser sessions only). Tab IDs come from ListTabs.

ParametersExpand Collapse

id: str

tab_id: str

ReturnsExpand Collapse

class ActionResult: …

error_message: Optional[str]

executed_tab_id: Optional[str]

page_context: Optional[V2GoBackendInternalTypesPageContext]

device_scale_factor: Optional[float]

is_main_tab: Optional[bool]

page_height: Optional[int]

page_width: Optional[int]

scroll_x: Optional[float]

scroll_y: Optional[float]

tab_id: Optional[str]

title: Optional[str]

url: Optional[str]

viewport_height: Optional[int]

viewport_width: Optional[int]

request_id: Optional[str]

result: Optional[Dict[str, object]]

status: Optional[str]

timestamp: Optional[str]

Switch to tab

Python

HTTP

TypeScript

Python

import os
from tzafon import Lightcone

client = Lightcone(
    api_key=os.environ.get("TZAFON_API_KEY"),  # This is the default and can be omitted
)
action_result = client.computers.tabs.switch(
    tab_id="tab_id",
    id="id",
)
print(action_result.executed_tab_id)

200 example

{
  "error_message": "error_message",
  "executed_tab_id": "executed_tab_id",
  "page_context": {
    "device_scale_factor": 0,
    "is_main_tab": true,
    "page_height": 0,
    "page_width": 0,
    "scroll_x": 0,
    "scroll_y": 0,
    "tab_id": "tab_id",
    "title": "title",
    "url": "url",
    "viewport_height": 0,
    "viewport_width": 0
  },
  "request_id": "request_id",
  "result": {
    "foo": "bar"
  },
  "status": "status",
  "timestamp": "timestamp"
}

Returns Examples

200 example

{
  "error_message": "error_message",
  "executed_tab_id": "executed_tab_id",
  "page_context": {
    "device_scale_factor": 0,
    "is_main_tab": true,
    "page_height": 0,
    "page_width": 0,
    "scroll_x": 0,
    "scroll_y": 0,
    "tab_id": "tab_id",
    "title": "title",
    "url": "url",
    "viewport_height": 0,
    "viewport_width": 0
  },
  "request_id": "request_id",
  "result": {
    "foo": "bar"
  },
  "status": "status",
  "timestamp": "timestamp"
}