Layerbeat

Delete a server

DELETE
/v1/vms/{id}

Permanently deletes a VPS and its data. Set confirm to the server name. No refund is currently issued.

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.

Query Parameters

confirm*string

The server's name.

Header Parameters

X-Org-ID?string

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

Response Body

Accepted: deletion has started

application/json
  1. response
operation*
refund*

Always 0.00 for now: refunds on delete are not issued yet.

curl -X DELETE 'https://layerbeat.com/v1/vms/string?confirm=web-1'
{  "operation": {    "id": "op_4yw4xmradad4bstgr4d5qtreb4",    "type": "vm.delete",    "status": "pending",    "vm_id": "vm_gnkrp6zuxvsqki7sqxeluvsw2y",    "steps": [      {        "name": "delete",        "status": "running"      }    ],    "result": null,    "error": null,    "created_at": "2026-10-01T10:00:00Z",    "finished_at": null  },  "refund": {    "amount": "0.00",    "currency": "USD"  }}