Renew a VPS
POST/vms/:vm_id/renew
Adds the selected number of calendar months to the current paid term, or starts from the current time if it has expired. Uses current prices, markup and term discount. Renew before the service is deleted.
Send a unique Idempotency-Key for each intended action. If the response is lost, retry with the same key and unchanged parameters; do not create a new key for the same purchase.
HTTP 202 accepts the request; it does not confirm completion. Save the order_id or operation id and check its status.
Request rules and errors · Lifecycle · Webhooks
Administrative blocks: admin_blocked_at and admin_block_reason are separate from status. Renewal does not unblock or start the server. Restrictions and errors: administrative blocks.
Request
Responses
- 202
- 401
- 403
- 404
- 409
- 422
- 500
- 503
Accepted for processing
Missing or invalid key, mismatched ID, or inactive integration
Client IP is not in the integration allowlist (ip_not_allowed).
Resource not found in this integration
Business or state conflict; inspect detail
Invalid request fields or unsupported parameters
Unexpected server error
Service unavailable or result unconfirmed; for a mutation retain its idempotency key