---
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
      - `topic` 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
      - `appServerControlOnly` boolean, required
      - `profileHint` string, nullable, required
      - `appServerControlResumeThreadId` string, nullable, required
      - `hasAppServerControlHistory` 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
    - `lastResult` UpdateResult, required
      - `found` boolean, required
      - `success` boolean, required
      - `message` string, required
      - `details` string, required
      - `timestamp` string, required
      - `logFile` string, required
      - `rollbackAttempted` 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` AppServerControlTurnRequest, required
      - `text` string, nullable
      - `model` string, nullable
      - `effort` string, nullable
      - `planMode` string, nullable
      - `permissionMode` string, nullable
      - `fastMode` string, nullable
      - `attachments` AppServerControlAttachmentReference[], required
        - `kind` string, required
        - `path` string, required
        - `mimeType` string, nullable, required
        - `displayName` string, nullable, required
      - `terminalReplay` AppServerControlTerminalReplayStep[], 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
    - `repeatEveryMs` integer, nullable, required
    - `repeatCount` integer, nullable, required
    - `ignoreHeatUntil` string, date-time, nullable, required
    - `awaitingHeatRise` boolean, required
  - `terminalSizeControls` TerminalSizeControlStatus[], nullable, required
    - `sessionId` string, required
    - `isOwner` boolean, required
    - `hasOwner` boolean, required
    - `ownerOnline` boolean, required
    - `ownerInSameBrowserProfile` boolean, required
    - `canTakeOverAutomatically` boolean, required
    - `ownerLabel` string, nullable, required
    - `epoch` integer, required

## Changes

- **2026-08-25** `52036f67f5a5` — 1 info
  - added the optional property `managerBarQueue/items/turn/oneOf[#/components/schemas/AppServerControlTurnRequest]/fastMode` to the response with the `200` status
- **2026-08-09** `a42008ebe168` — 3 info
  - added the required property `managerBarQueue/items/repeatCount` to the response with the `200` status
  - added the required property `managerBarQueue/items/repeatEveryMs` to the response with the `200` status
  - added the required property `update/oneOf[#/components/schemas/UpdateInfo]/lastResult` to the response with the `200` status
- **2026-07-20** `ebcaff833b7c` — 2 info
  - added the required property `terminalSizeControls/items/ownerInSameBrowserProfile` to the response with the `200` status
  - added the required property `terminalSizeControls/items/ownerLabel` to the response with the `200` status
- **2026-07-20** `b841af69769a` — 1 info
  - added the required property `terminalSizeControls` to the response with the `200` status
- **2026-05-13** `f43ccea8bcc5` — 1 info
  - added the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/topic` to the response with the `200` status

[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/04072327b4e0/schema)