Renewals and expiry
Extend a subscription, set automatic renewal limits and understand the grace period.
A VPS is prepaid for a fixed term. Check expires_at on the server and keep enough available credit in the currency you will use for renewal.
Renew manually
Any member with server write access can renew using their own personal credit. An API key charges its creator. Read the current renewal settings and available term prices first:
curl -sS "$BASE/v1/vms/$VPS_ID/renewal?currency=USD" \
-H "Authorization: Bearer $LAYERBEAT_API_KEY"Submit the selected term, currency and spending limit:
export RENEW_REQUEST_ID=$(uuidgen)
curl -sS -X POST "$BASE/v1/vms/$VPS_ID/renew" \
-H "Authorization: Bearer $LAYERBEAT_API_KEY" \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $RENEW_REQUEST_ID" \
--data '{"term_months":1,"currency":"USD","maximum_amount":"YOUR_REVIEWED_LIMIT"}'Replace the limit with a numeric string equal to or above the reviewed term price. maximum_amount is a ceiling, not an instruction to charge that amount. For IDR, use a whole-Rupiah string.
Poll the returned operation. 202 reserves credit and begins processing; it does not confirm that the expiry has already changed. A definitive failure before submission releases the hold. An uncertain submission keeps it while the existing renewal is reviewed.
Renewal pricing
Where a term and currency have a purchase-time price lock, renewal uses that locked price, including a discount in effect when the server was purchased. Other terms or currencies use the published renewal price. Read the renewal response rather than inferring the price from a current new-server plan.
Enable automatic renewal
Automatic renewal is off by default. Only the original purchaser can enable or disable charges from their credit. Save the term, currency and maximum amount using the console or PUT /v1/vms/{id}/renewal.
Attempts begin 48 hours before expiry. Each attempt checks the saved consent, current write access, verified eligibility and available balance. USD and IDR are never combined. Saving consent alone does not submit a renewal.
Changing your default billing currency does not change existing consent. Update the renewal policy explicitly if you want to use another balance. Check renewals_enabled to see whether new renewals are currently admitted.
Expiry and grace
The renewal response includes renewal_deadline, normally eight days after expiry for a Layerbeat-purchased VPS. Renewal during grace is subject to the server still being recoverable. No new renewal is accepted at or after that deadline.
Layerbeat schedules reminders before expiry and during grace. Check your account email and available credit; an email is not proof of a successful charge.
When the Layerbeat service closes after grace, it is shown as Deleted from Layerbeat and management and renewal are blocked. This local closure is distinct from an explicit infrastructure deletion and does not assert that disks have been physically erased. Keep your own backups before expiry.
If a renewal is pending or uncertain, check its operation before attempting another order. For errors and support details, see troubleshooting.