taikutaiku
User GuidePluginsAPI Reference
Remote Commands
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
X-Taiku-Token<token>

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

In: header

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

application/json

text/plain

text/plain

text/plain

text/plain

text/plain

text/plain

curl -X GET "/api/v1/sessions/string/remote/workspaces"
{
  "result": {
    "pages": [
      {
        "index": 0
      },
      {
        "index": 1
      }
    ],
    "activeIndex": 0
  }
}
"Command failed"
"Unauthorized"
"Not the session owner"
"Session not found"
"Session closed"
"No active browser clients responded"