---
title: "change mail server plan"
method: POST
path: "/api/v1/mails/{mailServerID}/plan"
tags: ["plan"]
---

# change mail server plan

`POST /api/v1/mails/{mailServerID}/plan`

Upgrades take effect immediately, while downgrades are scheduled and applied after the current plan ends. Click on the request body schema to see all available plans.

## Path parameters

- `mailServerID` string, required

## Request body

- object
  - `planName` 'm1' | 'm2' | 'm3' | 'm4' | 'm5' | 'm6' | 'm7' | 'm8'

## Response `200`

OK

## Other responses

- `400` — Bad Request - Invalid request for plan
- `402` — Not enough balance.
- `403` — You are allowed to create only one Mail Server on the free plan.
- `404` — Mail Server not found
- `428` — You are already on the same plan
- `500` — Unexpected error

---

[API](https://skmtc.net/liara-cloud/apis/liara-mail-api-documentaion.md) · [All operations](https://skmtc.net/liara-cloud/apis/liara-mail-api-documentaion/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liara-cloud/liara-mail-api-documentaion/versions/5ae39ee353b2/schema)