Sign up

Delete a backup

POST/api/v1/vps/{vps_uuid}/backups/delete

Deletes one backup.

Parameters

NameInDescription
vps_uuidpath, stringrequiredVPS id, from Create a VPS or List VPS

Request body

FieldTypeDescription
backup_idstring, optionalrequiredA backup id from GET /vps/{vps_uuid}/backups

Example request

curl -X POST "https://platform.serverscamp.com/api/v1/vps/$VPS_UUID/backups/delete" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "backup_id": "bk-3f9a1c0d2e4b5a69"
  }'

Answer

Status 200 with this body.

FieldTypeDescription
vps_uuidstringrequired
deletedstringrequiredId of the deleted backup
{
  "vps_uuid": "12d46f8c-d66e-4163-99aa-1245d5b06e5b",
  "deleted": "bk-3f9a1c0d2e4b5a69"
}

Errors

StatusWhen
401No token, or a token that is not valid
404No such backup of this VPS
422The body or a parameter is not what the operation takes

Every operation can also answer 401 without a valid token. All errors