Get desktop runtime status.

Returns the current desktop runtime state, dependency status, active display metadata, and supervised process information.

GET /v1/desktop/status

Get desktop runtime status.

cURL

curl --request GET \
  --url http://localhost:2468/v1/desktop/status

200

{
  "state": "inactive",
  "display": "<string>",
  "installCommand": "<string>",
  "missingDependencies": [
    "<string>"
  ],
  "processes": [
    {
      "name": "<string>",
      "running": true,
      "logPath": "<string>",
      "pid": 1
    }
  ],
  "runtimeLogPath": "<string>",
  "startedAt": "<string>",
  "windows": [
    {
      "height": 1,
      "id": "<string>",
      "isActive": true,
      "title": "<string>",
      "width": 1,
      "x": 123,
      "y": 123
    }
  ]
}

Response

200

application/json

Desktop runtime status

state · enum<string> · required

Available options: inactive, install_required, starting, active, stopping, failed

display · string | null

installCommand · string | null

lastError · object

Show child attributes

missingDependencies · string[]

processes · object[]

Show child attributes

resolution · object

Show child attributes

runtimeLogPath · string | null

startedAt · string | null

windows · object[]

Current visible windows (included when the desktop is active).

Show child attributes