---
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
      - `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
      - `agentControlled` boolean, required
      - `lensOnly` boolean, required
      - `profileHint` 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

## Changes

- **2026-03-27** `536b8636ac1e` — 11 breaking, 2 info
  - removed the required property `layout` from the response with the `200` status
  - removed the required property `managerBarQueue` from the response with the `200` status
  - removed the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/appServerControlOnly` from the response with the `200` status
  - removed the required property `sessions/oneOf[#/components/schemas/SessionListDto]/sessions/items/appServerControlResumeThreadId` from the response with the `200` status
  - …9 more

[Change 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/b075ca8537ea/schema)