---
title: "GET /api/state"
method: GET
path: "/api/state"
tags: ["Ai.Tlbx.MidTerm.OpenApi"]
---

# GET /api/state

`GET /api/state`

## Response `200`

OK

- StateUpdate
  - `sessions` SessionListDto, required
    - `sessions` SessionInfoDto[], required
      - `id` string, required
      - `pid` integer, required
      - `createdAt` string, date-time, required
      - `isRunning` boolean, required
      - `exitCode` integer, nullable, required
      - `cols` integer, required
      - `rows` integer, required
      - `shellType` string, required
      - `name` string, nullable, required
      - `terminalTitle` string, nullable, required
      - `notes` string, nullable, required
      - `manuallyNamed` boolean, required
      - `currentDirectory` string, nullable, required
      - `foregroundPid` integer, nullable, required
      - `foregroundName` string, nullable, required
      - `foregroundCommandLine` string, nullable, required
      - `foregroundDisplayName` string, nullable, required
      - `foregroundProcessIdentity` string, nullable, required
      - `agentAttachPoint` SessionAgentAttachPoint, required
        - `provider` string, required
        - `transportKind` string, required
        - `endpoint` string, required
        - `sharedRuntime` boolean, required
        - `source` string, required
        - `preferredThreadId` string, nullable, required
      - `order` integer, required
      - `parentSessionId` string, nullable, required
      - `bookmarkId` string, nullable, required
      - `spaceId` string, nullable, required
      - `workspacePath` string, nullable, required
      - `surface` string, nullable, required
      - `isAdHoc` boolean, required
      - `agentControlled` boolean, required
      - `lensOnly` boolean, required
      - `profileHint` string, nullable, required
      - `lensResumeThreadId` string, nullable, required
      - `hasLensHistory` boolean, required
      - `supervisor` SessionSupervisorInfoDto, required
        - `state` string, required
        - `profile` string, required
        - `needsAttention` boolean, required
        - `attentionReason` string, nullable, required
        - `attentionScore` integer, required
        - `lastInputAt` string, date-time, nullable, required
        - `lastOutputAt` string, date-time, nullable, required
        - `lastBellAt` string, date-time, nullable, required
        - `currentHeat` number, double, required
  - `update` UpdateInfo, required
    - `available` boolean, required
    - `currentVersion` string, required
    - `latestVersion` string, required
    - `releaseUrl` string, required
    - `downloadUrl` string, nullable, required
    - `assetName` string, nullable, required
    - `releaseNotes` string, nullable, required
    - `type` 'none' | 'webOnly' | 'full', required
    - `sessionsPreserved` boolean, required
    - `environment` string, nullable, required
    - `localUpdate` LocalUpdateInfo, required
      - `available` boolean, required
      - `version` string, required
      - `path` string, required
      - `type` 'none' | 'webOnly' | 'full', required
      - `sessionsPreserved` boolean, required
    - `isDowngrade` boolean, required
  - `layout` SessionLayoutState, required
    - `revision` integer, required
    - `root` LayoutNode, required
      - `type` string, required
      - `sessionId` string, nullable, required
      - `direction` string, nullable, required
      - `children` LayoutNode[], nullable, required
    - `focusedSessionId` string, nullable, required
  - `managerBarQueue` ManagerBarQueueEntryDto[], nullable, required
    - `queueId` string, required
    - `sessionId` string, required
    - `kind` string, required
    - `action` ManagerBarButton, required
      - `id` string, required
      - `label` string, required
      - `text` string, required
      - `actionType` string, required
      - `prompts` string[], required
      - `trigger` ManagerBarTrigger, required
        - `kind` string, required
        - `repeatCount` integer, required
        - `repeatEveryValue` integer, required
        - `repeatEveryUnit` string, required
        - `schedule` ManagerBarScheduleEntry[], required
          - `timeOfDay` string, required
          - `repeat` string, required
    - `turn` LensTurnRequest, required
      - `text` string, nullable
      - `model` string, nullable
      - `effort` string, nullable
      - `planMode` string, nullable
      - `permissionMode` string, nullable
      - `attachments` LensAttachmentReference[], required
        - `kind` string, required
        - `path` string, required
        - `mimeType` string, nullable, required
        - `displayName` string, nullable, required
      - `terminalReplay` LensTerminalReplayStep[], required
        - `kind` string, required
        - `text` string, nullable, required
        - `path` string, nullable, required
        - `mimeType` string, nullable, required
        - `useBracketedPaste` boolean, required
    - `phase` string, required
    - `nextPromptIndex` integer, required
    - `completedCycles` integer, required
    - `nextRunAt` string, date-time, nullable, required
    - `ignoreHeatUntil` string, date-time, nullable, required
    - `awaitingHeatRise` boolean, required

## Changes

- **2026-04-25** `cbbe49e2b3e2` — 1 info
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/notes` to the response with the `200` status
- **2026-04-13** `a9161c71ae5a` — 1 info
  - added the required property `managerBarQueue/items/turn/oneOf[#/components/schemas/LensTurnRequest]/terminalReplay` to the response with the `200` status
- **2026-04-10** `2dab040c6e90` — 4 info
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/isAdHoc` to the response with the `200` status
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/spaceId` to the response with the `200` status
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/surface` to the response with the `200` status
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/workspacePath` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/tlbx-ai/apis/tlbx-api/changes/api/state/get.md)

---

[API](https://skmtc.dev/tlbx-ai/apis/tlbx-api.md) · [All operations](https://skmtc.dev/tlbx-ai/apis/tlbx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tlbx-ai/tlbx-api/revisions/cbbe49e2b3e2/schema)