---
title: "Reinstall an instance"
method: POST
path: "/v1/instances/{id}/reinstall"
tags: ["public", "instances"]
---

# Reinstall an instance

`POST /v1/instances/{id}/reinstall`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/instances/{id}/reinstall`
- Auth: API key in header `Authorization`

Rebuilds the server from a marketplace offering. The boot disk is erased. Requires confirm=true, typed_confirm set to the instance id, and acknowledge_unrecoverable=true. Needs instances:reinstall, which instances:write does not imply. A reinstall that would replace a recovery-critical secret cannot be made here -- use the dashboard, where each secret is shown and acknowledged. One that keeps every recovery-critical value (a customer-managed recovery key, for example) is accepted.

## Path parameters

- `id` string, required

## Request body

- ProvisioningPublicReinstallRequest
  - `acknowledge_unrecoverable` boolean
  - `confirm` boolean
  - `hostname` string
  - `offering` ProvisioningPublicReinstallOffering
    - `contract_token` string
    - `id` string
    - `inputs` object
  - `ssh_key_ids` string[]
  - `typed_confirm` string

## Response `202`

Accepted

- ProvisioningPublicAcceptedResponse
  - `status` string

## Other responses

- `400`: confirmation_required, offering_required or bad_json
- `401`: invalid or missing API key
- `403`: the key lacks instances:reinstall
- `404`: no such instance
- `409`: illegal_transition or offering_changed
- `422`: reinstall_not_supported (permanent; this server cannot be rebuilt in place), offering_unavailable, offering_incompatible, offering_inputs_invalid, invalid_reinstall_options, ssh_key_not_found, recovery_acknowledgement_required, or recovery_acknowledgement_unavailable — the last means reinstall this one from the dashboard
- `503`: reinstall_unavailable — temporarily unavailable; retry with backoff

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)