---
title: Changing the commercial type of an Instance with the API or CLI
description: This page explains how to change the commercial type of a Scaleway Instance with the API or CLI
tags: upgrade instance api
dates:
validation: 2025-09-17
posted: 2021-05-26
---
import Requirements from '@macros/iam/requirements.mdx'
It is possible to change the commercial type of an Instance using the [Scaleway CLI](/scaleway-cli/quickstart/) or the [Instances API](https://www.scaleway.com/en/developers/api/instances/).
To do so, you need the Instance’s ID and a valid API key.
If you prefer to perform Instance migration from the Scaleway console, refer to our [How to migrate Instances using the console](/instances/how-to/migrate-instances/) documentation.
- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- An [Instance](/instances/how-to/create-an-instance/), which must be stopped and not be in a placement group
Network interface names may vary across commercial families. Ensure that any hardcoded interface names in your configurations or scripts are updated to avoid migration issues.
Do **not** manually change the commercial type of **Kubernetes Kapsule nodes** using the API or CLI. Kubernetes Kapsule nodes **must be managed** through Kubernetes. Modifying node types outside of the recommended method can lead to instability or unexpected behavior.
To change the commercial type of your nodes, create a new node pool with the desired Instance type and [migrate your workloads](/kubernetes/how-to/manage-node-pools/#how-to-migrate-existing-workloads-to-a-new-kubernetes-kapsule-node-pool) to the new pool.
1. Stop the Instance.
```
scw instance server stop zone=
```
Replace `` with the Availability Zone of your Instance. For example, if your Instance is located in Paris-1, the zone would be `fr-par-1`. Replace `` with the ID of your Instance.
You can find the ID of your Instance on it's overview page in the Scaleway console or using the CLI by running the following command: `scw instance server list`.
2. Update the commercial type of the Instance
```
scw instance server update commercial-type= zone=
```
Replace `` with the desired new commercial type.
You can retrieve a list of all available Instance types using the command `scw instance server-type list`.
Ensure that Local Storage constraints are respected. For example, downgrading from a larger Instance type to a smaller one may not be possible if the smaller Instance type cannot support the existing Local Storage. Check the Scaleway documentation for specific constraints.
3. Power on the Instance.
```
scw instance server start zone=
```
You have successfully changed the commercial type of your Scaleway Instance using the Scaleway CLI. For further information, refer to the [Instance CLI documentation](https://github.com/scaleway/scaleway-cli/blob/master/docs/commands/instance.md).
1. Stop the Instance. Replace `{zone}` with the Availability Zone of your Instance. This value can be `fr-par-1` for Instances located in Paris, for example. Replace `{server_id}` with the ID of your Instance.
Request:
```
curl -X POST -H "X-Auth-Token: $SCW_SECRET_KEY" -H "Content-Type: application/json" -d '{"action" : "poweroff"}' "https://api.scaleway.com/instance/v1/zones/{zone}/servers/{server_id}/action"
```
Output:
```
{
"task":{
"id":"cd1cf3da-6dee-4c96-bc86-f4fe848f36d4",
"description":"server_poweroff",
"status":"pending",
"href_from":"/servers/85bde2188-1657-11ee-be56-0242ac120002/action",
"href_result":"/servers/85bde2188-1657-11ee-be56-0242ac120002",
"started_at":"2023-06-29T08:20:36.927830+00:00",
"terminated_at":null
}
}
```
2. Update the `commercial_type` of your Instance.
Request:
```
curl -X PATCH -H "X-Auth-Token: $SCW_SECRET_KEY" -H "Content-Type: application/json" -d '{"commercial_type" : ""}' "https://api.scaleway.com/instance/v1/zones/{zone}/servers/{server_id}"
```
Local Storage constraints must be respected. For example, downgrading a DEV1-L Instance with 80 GB of local SSD storage to a DEV1-S Instance is not possible because the DEV1-S offer only supports a maximum of 20 GB. However, if the DEV1-L Instance is only using Block Storage (`sbs_volume`) without relying on local SSD storage, the downgrade can be performed without any issues.
Output:
```
{
"server":{
"id":"85bde2188-1657-11ee-be56-0242ac120002",
"name":"scw-agitated-banach",
"arch":"x86_64",
"commercial_type":"PLAY2-MICRO", # New commercial type of the Instance
"boot_type":"local",
"organization":"a6a05c73-fa53-46a4-9ea1-e53b4f625527",
"project":"a6a05c73-fa53-46a4-9ea1-e53b4f625527",
"hostname":"scw-agitated-banach",
"image":{
"id":"ce453858-557c-4f1c-a7a9-70026e67d054",
"name":"Ubuntu 22.04 Jammy Jellyfish",
"organization":"4ce7eb1c-1659-11ee-be56-0242ac120002",
"project":"4ce7eb1c-1659-11ee-be56-0242ac120002",
"root_volume":{
"id":"30e9c843-1cdb-4bd4-96f7-cac26051eeaf",
"name":"Ubuntu 22.04 Jammy Jellyfish",
"volume_type":"sbs_volume",
"size":10000000000
},
[...]
```
3. Power on the Instance.
Request:
```
curl -X POST -H "X-Auth-Token: $SCW_SECRET_KEY" -H "Content-Type: application/json" -d '{"action" : "poweron"}' "https://api.scaleway.com/instance/v1/{zone}/servers/{server_id}/action"
```
Output:
```
{
"task":{
"id":"aca94c37-86b0-4c9a-8df0-3bc13cd568ac",
"description":"server_batch_poweron",
"status":"pending",
"href_from":"/servers/85bde2188-1657-11ee-be56-0242ac120002/action",
"href_result":"/servers/85bde2188-1657-11ee-be56-0242ac120002",
"started_at":"2023-06-29T08:27:49.409220+00:00",
"terminated_at":null
}
}
```
For more information on using the API, refer to the complete [API documentation](https://www.scaleway.com/en/developers/api/instances/).