# Keep machines booted from a template for instant creates

`POST /v1/pools`

**In this build:** Works on the simulator or a real VM.

**Scope:** `sandbox.create`

**CLI:** `harebox pool new`

Send an `Idempotency-Key` header. A retry with the same key never repeats the action.

## Request: `CreatePoolRequest`

| Field | Type | Notes |
|---|---|---|
| `name` | `string` |  |
| `template` | `string` |  |
| `size` | `Size` |  |
| `min_ready` (required) | `integer` |  |
| `labels` | `Labels` |  |

## Response: 201

`Pool`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `name` | `string` |  |
| `template` | `string or null` |  |
| `size` | `Size` |  |
| `min_ready` (required) | `integer` | Machines kept booted and waiting. They are billed at the Shared rate and count toward concurrency. |
| `ready` | `integer` | Waiting now. |
| `claimed` | `integer` |  |
| `labels` | `Labels` |  |
| `created_at` | `string` |  |

Errors follow [one format](../errors.html).