---
title: "Manage Dedicated Server Bandwidth via the OVHcloud API"
description: "Upgrade or downgrade the public bandwidth allocation on your dedicated server using the OVHcloud API."
url: https://docs.ovhcloud.com/en/guides/bare-metal-cloud/dedicated-servers/manage-bandwidth-api
lang: en
lastUpdated: 2025-01-20
---
# Manage Dedicated Server Bandwidth via the OVHcloud API

## Objective

Each of our dedicated servers includes a minimum public bandwidth of 500Mbps. If you have specific download or mass distribution requirements, such as software updates, you can upgrade the bandwidth. And if you need less bandwidth, you can also downgrade to a lower bandwidth.

**In this guide, we explain how you can easily upgrade or downgrade the bandwidth of a dedicated server.**

:::warning
Please note that this option is available on most dedicated servers, but not all. Although our servers come with a minimum public bandwidth of 500Mbps, the public bandwidth upgrade option is not available on all dedicated server ranges.
:::

## Requirements

- A [dedicated server](https://www.ovhcloud.com/en-gb/bare-metal/) in your OVHcloud account
- Access to the [OVHcloud API](/en/guides/manage-and-operate/api/first-steps.md)

## Instructions

### Find available services

Use the following API call to list all the available services for upgrade (or downgrade) and verify that the service you wish to upgrade/downgrade is listed:


🇪🇺EU▾

[GET/order/upgrade/baremetalPublicBandwidth](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/upgrade/baremetalPublicBandwidth)

![API call listing available public bandwidth services](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_01.png)
### Find the plan code

List available offers and find the **planCode** of your choice with the API call below:


🇪🇺EU▾

[GET/order/upgrade/baremetalPublicBandwidth/{serviceName}](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/upgrade/baremetalPublicBandwidth/-serviceName-)

Enter the variables:

- serviceName: the name of your dedicated server, for example `ns1234567.ip-203.0.113.eu`

![API call to list available bandwidth plan codes](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_02.png)
The `RESPONSE` field should display information similar to the following:

![API response showing available bandwidth plan codes](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_02_1.png)
### Review your order

Use the following API call for a preview of your order, including pricing:


🇪🇺EU▾

[GET/order/upgrade/baremetalPublicBandwidth/{serviceName}/{planCode}](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/upgrade/baremetalPublicBandwidth/-serviceName-/-planCode-)

Enter the variables:

- planCode: the reference retrieved in the previous step
- serviceName: the name of your dedicated server
- quantity: 1

![API call to preview the bandwidth order with pricing](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_03.png)
The `RESPONSE` field should display information similar to the following:

![API response with bandwidth order pricing details](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_03_1.png)
### Submit your order

To officially submit the order, use the following API call:


🇪🇺EU▾

[POST/order/upgrade/baremetalPublicBandwidth/{serviceName}/{planCode}](https://eu.api.ovh.com/console/?section=/order&branch=v1#post-/order/upgrade/baremetalPublicBandwidth/-serviceName-/-planCode-)

![API call to submit the public bandwidth order](/images/bare-metal-cloud/dedicated-servers/manage-bandwidth-api/bandwidth_4.png)
The order will be processed once you have clicked `Execute
`. The amount displayed corresponds to your option’s first billing month, calculated on a pro rata basis for the current month.
## Go further

[Managing vRack Private Bandwidth via the OVHcloud API](/en/guides/bare-metal-cloud/dedicated-servers/manage-bandwidth-vrack-api.md)

[How to get started with a Dedicated Server](/en/guides/bare-metal-cloud/dedicated-servers/getting-started-with-dedicated-server.md)

Join our [community of users](https://community.ovhcloud.com/).