---
title: "Create Computer"
method: POST
path: "/computers"
---

# Create Computer

`POST /computers`

## Request body

- CreateComputerRequest — Create a ready Linux computer owned by one SDK client.
  - `computer_id` string, nullable
  - `template` 'linux-desktop'
  - `backend` 'firecracker' | 'qemu' | 'auto'
  - `display` BrowserViewportRequest — Requested browser viewport in CSS pixels.
    - `width` integer
    - `height` integer
  - `resources` ComputerResourcesRequest — CPU, memory, and disk requested for a Linux computer.
    - `memory_mib` integer
    - `disk_mib` integer
    - `vcpus` 2
  - `network` union
    - OpenNetworkPolicy — Allow all outbound network access.
      - `mode` 'open', required
    - OffNetworkPolicy — Block outbound network access.
      - `mode` 'off', required
    - RestrictedNetworkPolicy — Allow outbound access only to the supplied IPv4 ranges.
      - `mode` 'restricted', required
      - `allowed_cidrs` string[], required
  - `workspace` WorkspaceMount[]
    - `host_path` string, path, required
    - `guest_path` string
    - `mount_tag` string, nullable
    - `writable` boolean

## Response `201`

Successful Response

- ComputerResponse — A ready Linux computer and its grouped application endpoints.
  - `computer_id` string, required
  - `sandbox_id` string, required
  - `template` 'linux-desktop', required
  - `status` 'ready', required
  - `capabilities` string[], required
  - `display` ComputerDisplayResponse, required — Addresses for watching or controlling a computer display.
    - `viewer_url` string, required
    - `vnc_url` string, required
  - `browser` ComputerBrowserResponse, required — State and automation address for Chromium inside a computer.
    - `status` 'ready' | 'closed' | 'error', required
    - `cdp_url` string, nullable, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

## Changes

- **2026-09-14** `4d88cab246b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/celestoai/apis/smolvm/changes/computers/post.md)

---

[API](https://skmtc.dev/celestoai/apis/smolvm.md) · [All operations](https://skmtc.dev/celestoai/apis/smolvm/llms.txt) · [OpenAPI document](https://skmtc.dev/celestoai/apis/smolvm/revisions/4d88cab246b2?raw)