# Move running sandboxes to a version

`POST /v1/environments/{environment}/upgrade`

**In this build:** Real.

**Scope:** `environment.write`

**CLI:** `harebox env upgrade`

## Request: `UpgradeEnvironmentRequest`

| Field | Type | Notes |
|---|---|---|
| `version` | `integer` |  |
| `selector` | `string` |  |

## Response: 202

`Operation`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `kind` (required) | `string` |  |
| `status` (required) | `string` | One of: `pending`, `running`, `succeeded`, `failed`, `cancelled` |
| `target` | `string or null` |  |
| `percent` | `number or null` |  |
| `error` | `object` |  |
| `created_at` | `string` |  |
| `updated_at` | `string` |  |

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