---
title: "Get Sandbox Desktop"
method: GET
path: "/sandboxes/{sandbox_id}/desktop"
---

# Get Sandbox Desktop

`GET /sandboxes/{sandbox_id}/desktop`

Return a sanitized loopback desktop endpoint without opening it.

## Path parameters

- `sandbox_id` string, required

## Response `200`

Successful Response

- DesktopResponse — A sanitized loopback display endpoint for a running sandbox.
  - `protocol` 'vnc'
  - `host` '127.0.0.1' | 'localhost' | '::1', required
  - `port` integer, required
  - `viewer_url` string, required

## Other responses

- `404` — The sandbox was not found.
- `409` — No running desktop is available.
- `422` — Validation Error

## Changes

- **2026-07-24** `05ed6bf1b0f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/celestoai/apis/smolvm/changes/sandboxes/:sandbox_id/desktop/get.md)

---

[API](https://skmtc.dev/celestoai/apis/smolvm.md) · [All operations](https://skmtc.dev/celestoai/apis/smolvm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celestoai/smolvm/revisions/ad347836d68f/schema)