---
title: "Unarchive an instance."
method: PUT
path: "/instances/{instance_id}/unarchive"
tags: ["instances"]
---

# Unarchive an instance.

`PUT /instances/{instance_id}/unarchive`

Restore a previously archived customer instance, making it active and available for use again.

Required RBAC Policy: kots/app/[:appid]/license/[:licenseid]/update

## Path parameters

- `instance_id` string, required

## Response `200`

UnarchiveCustomerInstanceResponse contains the response to unarchive an instance

- object
  - `customerInstance` CustomerInstance
    - `active` boolean
    - `appStatus` string
    - `client` string
    - `cloud` string
    - `clusterId` string
    - `createdAt` string, date-time
    - `embeddedClusterVersion` string
    - `instanceId` string
    - `isAirgap` boolean
    - `isArchived` boolean
    - `isDummyInstance` boolean
    - `isEmbeddedCluster` boolean
    - `isKurl` boolean
    - `k8sVersion` string
    - `kotsVersion` string
    - `kurlNodeCountReady` integer
    - `kurlNodeCountTotal` integer
    - `lastActive` string, date-time
    - `licenseId` string
    - `replicatedSdkVersion` string
    - `serviceAccountId` string
    - `tags` InstanceTag[]
      - `instanceId` string
      - `key` string
      - `origin` string
      - `value` string
    - `versionHistory` CustomerInstanceVersionHistory[]
      - `clusterId` string
      - `downstreamChannelId` string
      - `downstreamReleaseSequence` integer
      - `instanceId` string
      - `intervalLast` string, date-time
      - `intervalStart` string, date-time
      - `nativeHelmCount` integer
      - `replHelmCount` integer
      - `versionLabel` string
  - `error` string

## Other responses

- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3/revisions/6fcf9e54aba4/schema)