User GuidePluginsAPI Reference
GET
/v1/sessions/{session_id}/remote/workspaces

Get all workspace pages and which one is active. Workspaces are like virtual desktops: each one has its own layout of tiles.

Authorization

apiKeyAuth
headerX-Taiku-Token<token>

Your API key from taiku login. Also available as TAIKU_TOKEN env var.

Path Parameters

session_id*string

Query Parameters

client?integer

Optional target browser client ID. Useful when multiple clients are connected to the same session.

Range0 <= value

Response Body

Workspace info.

application/json
  1. response

Remote command success envelope. Transport-level or command-level failures use non-2xx HTTP responses.

result*unknown

Successful browser-side command result. Shape depends on the requested method.

Example Request
curl -X GET '/api/v1/sessions/string/remote/workspaces'
Example Response
{  "result": {    "pages": [      {        "index": 0      },      {        "index": 1      }    ],    "activeIndex": 0  }}