# Commit to capacity for one year

`POST /v1/reservations`

**In this build:** Uses a stand-in for an external service. The record and rate are real. Commitment charging and capacity holds need a real fleet.

**Scope:** `billing.write`

**CLI:** `harebox reserve new`

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

## Request: `ReservationInput`

| Field | Type | Notes |
|---|---|---|
| `size` (required) | `SizeName` |  |
| `count` (required) | `integer` |  |
| `region` (required) | `Region` |  |
| `term_months` | `integer` | One of: `12` |

## Response: 201

`Reservation`

`Reservation`

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