Layerbeat

Renew a disk

POST
/v1/volumes/{id}/renew

Extends a disk by 1, 3 or 12 months at the price per GB it was bought at, charging your personal credit. Keep the same Idempotency-Key when retrying.

Access: API key: vm:write · Session: developer, admin or owner.

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

Idempotency-Key?string

A unique string (for example a UUID). Repeating the same request with the same key returns the original result instead of buying again.

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
term_months*integer
Value in1312
currency?string
Value in"USD""IDR"

Response Body

Accepted: credit is reserved and the renewal has started

application/json
  1. response
volume*

A Premium disk. It is billed on its own and keeps its data when detached.

operation*
curl -X POST 'https://layerbeat.com/v1/volumes/string/renew' \  -H 'Idempotency-Key: 7c1f1b0e-6f0c-4a5e-9c33-2d0c0f1c9a11' \  -H 'Content-Type: application/json' \  -d '{  "term_months": 1}'
{  "volume": {    "id": "vol_k3q9w2m7c4x8z5t6v1b0n2h4ra",    "name": "data",    "status": "attached",    "type": "premium",    "region": "sgp",    "zone": "sgp-1",    "size_gb": 50,    "server": {      "id": "vm_gnkrp6zuxvsqki7sqxeluvsw2y",      "name": "web-1"    },    "mount_path": "/mnt/data",    "mounted": true,    "term_months": 1,    "billing": {      "currency": "USD",      "amount": "3.89"    },    "price_per_gb_month": {      "USD": "0.07770",      "IDR": "1384"    },    "expires_at": "2026-11-10T10:00:00Z",    "note": null,    "created_at": "2026-10-10T10:00:00Z",    "deleted_at": null  },  "operation": {    "id": "op_4yw4xmradad4bstgr4d5qtreb4",    "type": "volume.renew",    "status": "pending",    "vm_id": null,    "volume_id": "vol_k3q9w2m7c4x8z5t6v1b0n2h4ra",    "steps": [      {        "name": "renewing",        "status": "running"      }    ],    "result": null,    "error": null,    "created_at": "2026-10-10T10:00:00Z",    "finished_at": null  }}