Skip to main content

What is a Cloud Desktop?

A Cloud Desktop is a Windows desktop environment provisioned and managed by Nen, controllable via an API that exposes computer-use tools over HTTP. Each desktop provides:
  • A full Windows desktop (Windows Server 2022)
  • A controller API for tool discovery and execution (screenshot, click, type, scroll, and more)
  • Instant provisioning from a pre-warmed pool

Lifecycle

Desktops go through the following states:
StateDescription
runningDesktop is live, controller is accepting tool requests
deletedDesktop has been terminated
Desktops are provisioned from a pre-warmed pool — creation takes only a few seconds because instances are already booted and ready.

How It Works

  1. Create a desktop via the CLI (nen desktop create) or the API
  2. Discover tools by calling GET /desktops/{id}/tools — returns tool schemas compatible with any LLM
  3. Execute actions by calling POST /desktops/{id}/execute — send commands like screenshot, click, type
  4. Delete the desktop when you’re done
All communication goes through the Desktop API at desktop.api.getnen.ai, which authenticates requests and proxies them to the controller running on your desktop.

Next Steps

Create a Desktop

Provision your first desktop via CLI or API

Connect to a Desktop

Authentication and making your first tool call