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

Returns the binary split tree that describes how tiles are arranged. Useful for understanding what's on screen before you start rearranging things.

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

The layout tree.

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/layout'
Example Response
{  "result": {    "kind": "split",    "direction": "horizontal",    "ratio": 0.5,    "first": {      "kind": "leaf",      "tiles": [        1      ]    },    "second": {      "kind": "leaf",      "tiles": [        2      ]    }  }}