> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrade Instance

## API Description

When upgrading an instance, all parameters must be provided in full.

## Request Headers

**Content-Type** `string` *required*

Enum: `application/json`

**Authorization** `string` *required*

Bearer authentication format, for example: Bearer \{\{API Key}}.

## Request Body

**instanceId** `string` *required*

The ID of the instance to be upgraded.

**imageUrl** `string` *required*

Container image URL. String, length limit: 1-500 characters.

**imageAuthId** `string`

Image registry authentication ID.

**envs** `object[]` *required*

Instance environment variables. Up to 100 environment variable pairs can be created.

**properties**

**key** `string`

Environment variable name. String, length limit: 0-511 characters.

**value** `string`

Environment variable value. String, length limit: 0-4095 characters.

**command** `string` *required*

Container startup command. String, length limit: 0-2047 characters.

**entrypoint** `string` *required*

Container startup entrypoint. This setting will override the Docker image's ENTRYPOINT. String, length limit: 0-2047 characters.

**save** `boolean` *required*

Whether to retain data from the previous instance. Boolean, values: true or false.

**networkVolume** `object` *required*

Configure cloud storage (type: network). Each instance supports mounting up to 30 cloud storage volumes. To remove all cloud storage mounts, set volumeMounts to an empty array: \[].

**properties**

**volumeMounts** `object[]` *required*

Cloud storage mount information.

**properties**

**type** `string` *required*

Storage type. Must be set to network.

**id** `string` *required*

Cloud storage ID.

**mountPath** `string` *required*

Mount path for the cloud storage. Default: "/network". String, length limit: 1-4095 characters.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.