---
title: "GET /api/internal/desktop/ready"
method: GET
path: "/api/internal/desktop/ready"
tags: ["Desktop"]
---

# GET /api/internal/desktop/ready

`GET /api/internal/desktop/ready`

## Response `200`

Desktop runtime ready status

- object
  - `ready` boolean, required
  - `coreReady` boolean, required
  - `degraded` boolean, required
  - `bootPhase` 'preparing' | 'starting-managed-runtime' | 'attaching-external-runtime' | 'reconciling-runtime' | 'stabilizing-runtime' | 'ready', required
  - `workspacePath` string, required
  - `controlPlane` object, required
    - `ok` boolean, required
    - `phase` 'disconnected' | 'connecting' | 'ready' | 'degraded', required
    - `wsConnected` boolean, required
  - `status` 'active' | 'starting' | 'degraded' | 'unhealthy', required

## Changes

- **2026-04-15** `5d6d2a1b9f79` — 1 breaking, 4 info
  - removed the required property `runtime` from the response with the `200` status
  - added the required property `bootPhase` to the response with the `200` status
  - added the required property `controlPlane` to the response with the `200` status
  - added the required property `coreReady` to the response with the `200` status
  - …1 more
- **2026-03-24** `68f5b8d92036` — 1 warning
  - added the new `starting` enum value to the `status` response property for the response status `200`
- **2026-03-20** `c7cd7b6876c5` — 1 info
  - added the required property `workspacePath` to the response with the `200` status
- **2026-03-20** `8c508309a69a` — 1 info
  - endpoint added
- **2026-03-19** `239b3cc94d80` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nexu-io/apis/nexu-controller-api/changes/api/internal/desktop/ready/get.md)

---

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