Layerbeat

Set opt-in automatic renewal

PUT
/v1/vms/{id}/renewal

Updates automatic renewal using the original purchaser's credit. Saving settings does not renew the VPS immediately.

Access: Original purchaser with vm:write. Sessions require developer access or higher.

Authorization

headerAuthorizationBearer <token>

Send Authorization: Bearer <token>. A token is an API key (lb_live_…, scoped, for programs) or a session (lb_sess_…, from signup or login, for people). See Authentication above.

Path Parameters

id*string

The resource id.

Header Parameters

X-Org-ID?string

Sessions only: act on this organization (you must be a member). Default: your first organization.

Request Body

application/json
  1. body
currency?string

Selected personal credit balance. Never converts or combines balances.

Value in"USD""IDR"
auto_renew*boolean
term_months*integer
Value in1312
maximum_amount*string

Response Body

Saved consent settings

application/json
  1. response
currency?string
Value in"USD""IDR"
price_currency?string
Value in"USD""IDR"
auto_renew*boolean
can_manage*boolean
renewals_enabled*boolean
term_months*integer
Value in1312
maximum_amount*string
renew_at*|
Formatdate-time
renewal_deadline*|

Recorded expiry plus eight days for a Layerbeat-purchased server. No new renewal reserves credit at or after this time. Null for imports without an original purchaser.

Formatdate-time
deletion_at*|

Earliest removal from Layerbeat, only when the local subscription closure gate and renewals are enabled. Pending or uncertain renewals block closure. This does not authorize physical infrastructure deletion or confirm data erasure.

Formatdate-time
active_operation_id*string|null
options*array<>
curl -X PUT 'https://layerbeat.com/v1/vms/string/renewal' \  -H 'Content-Type: application/json' \  -d '{  "auto_renew": true,  "term_months": 1,  "maximum_amount": "12.00"}'
{  "auto_renew": false,  "can_manage": true,  "renewals_enabled": false,  "term_months": 1,  "maximum_amount": "12.00",  "renew_at": "2026-10-29T10:00:00Z",  "renewal_deadline": "2026-11-08T10:00:00Z",  "deletion_at": null,  "active_operation_id": null,  "options": [    {      "term_months": 1,      "amount": "12.00"    }  ]}