---
type: api
title: Set size overrides
description: Applies size overrides for the given instances belonging to the given resource. Instance size overrides will be reset with the next plan change.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-set-instance-settings-overrides
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-set-instance-settings-overrides
products:
  - Elastic Cloud Enterprise
---

# Set size overrides

## Paths

- `PUT` `/deployments/{deployment_id}/{resource_kind}/{ref_id}/instances/{instance_ids}/overrides`

- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#basicauth)
- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#apikey)

#### Path Parameters

- `deployment_id` (string)
  Identifier for the Deployment.
- `resource_kind` (string)
  The kind of resource. Only Elasticsearch resources are currently supported.
- `ref_id` (string)
  User-specified RefId for the Resource (or '_main' if there is only one).
- `instance_ids` ([] string)
  A comma-separated list of instance identifiers.

## Description

Applies size overrides for the given instances belonging to the given resource. Instance size overrides will be reset with the next plan change.

## Query String Parameters

- `restart_after_update` (boolean · default: false)
  After overrides are set, restarts the instance to apply the changes.
- `ignore_missing` (boolean · default: false)
  When `false` and a specified instance is missing, will return an error and not update any instances. When `true` will update only existing instances and not treat a missing instance as an error.

## Request Body

`application/json`

The overrides to apply to the given instances. Capacity overrides the RAM size in MB of the instance, and storage multipler overrides the multiplier of the instance RAM size that determines the storage quota of the instance. Capacity must be in the range [1024, <<instance configuration max increment, typically 65536>>] and storage multiplier must be in the range [1.0, 1000.0].

- `capacity` (integer) — optional
  Sets the memory capacity for the instances container. Requires a restart to take effect.
- `storage_multiplier` (number) — optional
  Overrides the disk quota multiplier for the instance

## Responses

#### `200`

The updated overrides

`application/json`

- `capacity` (integer)
  Sets the memory capacity for the instances container. Requires a restart to take effect.
- `storage_multiplier` (number)
  Overrides the disk quota multiplier for the instance
#### `404`

* The deployment specified by {deployment_id} cannot be found. (code: `deployments.deployment_not_found`)
* The Resource specified by {ref_id} cannot by found. (code: `deployments.deployment_resource_not_found`)
* One or more instances weren't found, and `ignore_missing` is false or unspecified. (code: `deployments.instances_missing_on_update_error`)
* The specified override was out of range. Capacity must be in the range [1024, <<instance configuration max increment, typically 65536>>] and storage multiplier must be in the range [1.0, 1000.0]. (code: `instance_overrides.out_of_range`)

`application/json`

- `errors` ([] BasicFailedReplyElement)
  A list of errors that occurred in the failing request
  - `code` (string)
    A structured code representing the error type that occurred
  - `message` (string)
    A human readable message describing the error that occurred
  - `fields` ([] string)
    If the error can be tied to a specific field or fields in the user request, this lists those fields
##### Response Headers

- `x-cloud-error-codes` (enum)
  The error codes associated with the response

## Code Examples

#### Console

```console
PUT /deployments/{deployment_id}/{resource_kind}/{ref_id}/instances/{instance_ids}/overrides
```

#### curl

```curl
curl -X PUT "/deployments/{deployment_id}/{resource_kind}/{ref_id}/instances/{instance_ids}/overrides"
```