# Reserve an IP

`POST /v1/static-ips`

**In this build:** Uses a stand-in for an external service. The record and lifecycle are real. Addresses, DNS and TLS need a deployed network.

**Scope:** `network.write`

**CLI:** `harebox ip reserve`

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

## Request: `ReserveIpRequest`

| Field | Type | Notes |
|---|---|---|
| `region` (required) | `Region` |  |
| `family` | `string` | One of: `ipv4`, `ipv6` |

## Response: 201

`StaticIp`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `address` (required) | `string` |  |
| `region` (required) | `Region` |  |
| `attached_to` | `string or null` |  |

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