API Documentation

Restore Backup

Restore a VPS from a specific backup. This will overwrite the current state of the VPS.

Request

POST /api/v1/vps/{id}/backups/{backupId}/restore

Required scope: vps:manage

Path Parameters

Parameter Type Description
id string The VPS ID
backupId string The backup ID to restore from

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

No request body is required.

Response

{
  "data": {
    "backupId": "backup_abc123",
    "success": true
  }
}

Errors

Status Code Description
400 INVALID_BACKUP_ID Backup ID is missing or invalid
404 NOT_FOUND VPS not found or not accessible
502 PROVIDER_ERROR Upstream provider error

Example

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups/backup_abc123/restore" \
  -H "Authorization: Bearer YOUR_API_KEY"

MCP

This action is also available via the restore_backup MCP tool.