# Take a whole host for this account

`POST /v1/dedicated-hosts`

**In this build:** Works on the simulator or a real VM. The record, placement on the host and its billing are real. With no empty host in the pool, it waits as provisioning: renting a new host for one account is the autoscaler's job, which doesn't do it yet.

**Scope:** `account.admin`

**CLI:** `harebox dedicated new`

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

## Request: `CreateDedicatedHostRequest`

| Field | Type | Notes |
|---|---|---|
| `name` | `string` |  |
| `region` | `Region` |  |

## Response: 201

`DedicatedHost`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `name` | `string` |  |
| `region` (required) | `Region` |  |
| `status` (required) | `string` | One of: `provisioning`, `ready`, `released` |
| `host` | `string or null` |  |
| `site` | `string or null` |  |
| `cpu` | `string or null` |  |
| `slots` (required) | `integer` | Default-size sandboxes it holds. |
| `usd_month` (required) | `number` | Every slot at the default Shared rate for 730 hours, charged daily from the wallet while ready. |
| `created_at` | `string` |  |
| `ready_at` | `string or null` |  |
| `released_at` | `string or null` |  |

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