Skip to main content

​
CLI

Create a cloud desktop with the Nen CLI: 
nen desktop create
The command returns the desktop ID and metadata: 
Desktop created successfully!

  Desktop ID:   dsk_abc123def456
  Status:       running
  Created:      2026-03-31T12:14:20-07:00
Desktops are provisioned from a pre-warmed pool, so creation typically takes just a few seconds.

​
API

Create a desktop programmatically: 
curl -X POST 'https://desktop.api.getnen.ai/desktops' \
  -H 'Authorization: Bearer sk_nen_...' \
  -H 'Content-Type: application/json' \
  -d '{}'
Request body:
FieldTypeDescription
desktop_typestringOptional. Defaults to "sandbox", which is currently the only supported value.
Sending an empty body ({}) is equivalent to {"desktop_type": "sandbox"}. Response: 
{
  "desktop_id": "dsk_abc123def456",
  "desktop_type": "sandbox",
  "status": "running",
  "workspace_id": "ws_org_abc",
  "name": "dsk-us-west-2-42",
  "created_at": 1743447260,
  "updated_at": 1743447260
}
FieldTypeDescription
desktop_idstringUnique identifier. Use this in subsequent /desktops/{id}/... calls.
desktop_typestringAlways "sandbox" at the moment.
statusstringrunning on success.
workspace_idstringThe workspace (organization) that owns this desktop.
namestringHuman-readable name, if the underlying instance has one. Optional.
created_atint64Unix timestamp (seconds since epoch).
updated_atint64Unix timestamp (seconds since epoch).

​
Check Status

nen desktop status dsk_abc123def456

  Desktop ID:   dsk_abc123def456
  Status:       running
  Created:      2026-03-31T12:14:20-07:00

​
Next Steps

Connect to Your Desktop

Set up authentication and make your first tool call

Quickstart

Run a complete agent loop