---
search:
  tags:
    - Computers
    - POST
seo:
  description: >-
    Creates a sandbox desktop through the computer-use gateway, owned by your
    account. The… Reference for the POST /v1/computers endpoint in the Webfold
    API.
sidebar:
  label: Create a sandbox computer
  badge: POST
title: Create a sandbox computer
type: openapi-operation
---
Creates a sandbox desktop through the computer-use gateway, owned by your account. The tenant is taken from your API key, never from the request. Metered as `computer.create`; the other computer endpoints require the `computer.access` entitlement. Pass a gateway capability token in the `X-Computer-Token` header on calls that need one.

`POST /v1/computers`

**Request body** (`application/json`)

- `width` (integer)
- `height` (integer)
- `workload` (string)
- `max_lifetime_secs` (integer)
- `idle_timeout_secs` (integer)

Request body example:

```json
{
  "width": 0,
  "height": 0,
  "workload": "string",
  "max_lifetime_secs": 0,
  "idle_timeout_secs": 0
}
```

**Responses**

- `201` — The computer, as the gateway returns it.
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `502` — Upstream service (arXiv, YouTube, web page) failed
- `503` — The backing service is not configured or is busy

Response example, 201:

```json
{}
```