Skip to main content
POST
/
reset
curl -X POST "http://CONTROL_PLANE_IP:PORT/reset" \
  -H "Content-Type: application/json" \
  -d '{
    "vm_id": "vm-abc123"
  }'

{
  "status": "accepted",
  "message": "Environment reset started",
  "vm_id": "vm-abc123",
  "task_id": "uuid-string",
  "status_url": "/task_status/uuid-string"
}
Resets the desktop environment to its initial state. Runs as a background task. Optionally accepts a new task configuration to initialize after reset.

​
Request Body

​
vm_id
string
required
VM identifier
​
task_config
object
Optional task configuration to initialize after reset

​
Response

​
status
string
Request status (accepted)
​
message
string
Status message
​
vm_id
string
VM identifier
​
task_id
string
Background task ID for status polling
​
status_url
string
URL to check task status
curl -X POST "http://CONTROL_PLANE_IP:PORT/reset" \
  -H "Content-Type: application/json" \
  -d '{
    "vm_id": "vm-abc123"
  }'

{
  "status": "accepted",
  "message": "Environment reset started",
  "vm_id": "vm-abc123",
  "task_id": "uuid-string",
  "status_url": "/task_status/uuid-string"
}