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

# Changing an IX Configuration with the API

> This help topic describes how to use the Megaport API to change the configured details of an IX.

export const Image = ({src, alt = '', caption, width, height, shadow}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  const img = <img className={['mega-image-style', shadow ? 'shadow' : ''].join(' ')} src={src} alt={alt} width={width} height={height} style={{
    display: 'block'
  }} />;
  return caption ? <figure>
      {img}
      <figcaption style={{
    textAlign: 'center',
    width
  }}>{caption}</figcaption>
    </figure> : img;
};

This topic describes how to change configuration details of an existing IX. For more information, see [PUT Update IX](https://dev.megaport.com/#6ae89dd9-e4bd-4fb5-8533-f8a4a0d02385) in the API reference.

You can change the IX service name, rate limit, cost center, contract term, VLAN ID, MAC address, ASN, BGP password, whether your IX traffic graphs are public or private, reverse DNS, A-End productUid (for moving an IX), and whether to shut down or re-enable an IX, by updating any of these parameters in the Body of the request:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "name": "My updated API created IX",
  "rateLimit": 500,
  "costCentre": "My Port Account",
  "term": 12,
  "vlan": 1650,
  "macAddress": "01:02:0f:04:58:20", 
  "asn": 136999,
  "password": "gbixpassword",
  "publicGraph": false,
  "reverseDns": "as6533.charlotte.com",
  "aEndProductUid": "9e8ad9d7-85ab-46f9-ab13-c0966891341b",
  "shutdown": true
}
```

<Callout icon="triangle-exclamation" color="red">
  If the IX is on a contract term, there are restrictions on speed changes. You can increase the speed above the committed term speed or reduce it to the committed term speed, but you cannot reduce it below the committed term speed. Attempting to reduce the speed below the committed term speed will result in a `409 Conflict` error. For more information, see [Changing the Speed of a Termed IX](/ix/ix-termed-rate-change).
</Callout>

For details on moving an IX, see [Moving a VXC and IX with the API](/api/api-vxc-move).

For details on shutting down an IX, see [Shutting Down a VXC and IX with the API](/api/api-vxc-shut-down).

Before you begin, obtain a valid access token. For more information, see [Creating an API Key](/api/api-key).

**To change the IX details in the Postman collection**

1. In Postman, expand **Internet Exchange (IX)** in the left navigation and click **PUT Update IX**.

2. Identify the IX to update by adding the `productUid` to the endpoint.
   <Image src="/images/api/api-ix-change-put-url.png" alt="Update IX request" shadow={true} width={800} />

3. Select the **Body** tab and update IX details for name, rate limit, VLAN ID, BGP password, and so on. You only need to include the values you want to change.\
   This example changes the following values.
   <Image src="/images/api/api-ix-change-params.png" alt="Update IX request" shadow={true} width={800} />

4. Click **Send**.\
   The changes will be reflected in the Portal within two minutes.
   <Image src="/images/api/api-ix-updated-params.png" alt="Updated IX details" shadow={true} width={500} />