# Get a desktop stream URL

`POST /v1/sandboxes/{sandbox}/desktop`

**In this build:** Works on the simulator or a real VM. Needs a real machine. The simulator returns placeholder results.

**Scope:** `desktop`

**CLI:** `harebox desktop`

## Request: `DesktopRequest`

| Field | Type | Notes |
|---|---|---|
| `view` | `string` | One of: `desktop`, `browser`, `spectator` |
| `resolution` | `string` | One of: `720p`, `1080p`, `1440p`, `4k` |
| `fps` | `integer` | One of: `30`, `60` |
| `theme` | `string` | One of: `light`, `dark` |
| `expires_seconds` | `integer` |  |

## Response: 200

`DesktopSession`

| Field | Type | Notes |
|---|---|---|
| `url` (required) | `string` |  |
| `expires_at` (required) | `string` |  |
| `view` | `string` |  |

Errors follow [one format](../errors.html).