---
title: "Renew a server · API | Rdp.Vision"
description: "POST /servers/{id}/renew: Extends the server, paid from the balance at the plan’s monthly price."
url: https://rdp.vision/docs/api/servers/renew
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Frenew.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Frenew.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

Servers

# Renew a server

Extends the server, paid from the balance at the plan’s monthly price.

POST`/servers/{id}/renew`

## Authorization

`Authorization`header required

`Bearer rv_…`, a key with the `renew` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Path parameters

`id`string (uuid) required

The server id from List servers.

## Body

application/json

`duration`integer optional, default 1

Months, 1 to 12.

## Response

`success`boolean

`new_expiry`string (datetime)

Paid until.

`cost`string (decimal)

Charged from the balance, USD.

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 402 | The balance doesn’t cover it. detail has message, required and balance.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl -X POST "https://rdp.vision/api/v1/servers/3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36/renew" \\
  -H "Authorization: Bearer $RDPVISION\_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"duration":3}'

Response

{
  "success": true,
  "new\_expiry": "2027-03-12T18:20:57+00:00",
  "cost": "39.00"
}