Create Backup
Creates a new backup of the VPS. The backup process runs asynchronously.
Request
POST /api/v1/vps/{id}/backups
Required scope: vps:manage
Path Parameters
| Parameter |
Type |
Description |
id |
string |
The VPS ID |
Headers
| Header |
Required |
Value |
Authorization |
Yes |
Bearer YOUR_API_KEY |
Request Body (optional)
| Field |
Type |
Description |
label |
string |
Optional label for the backup (max 100 characters) |
{
"label": "Before update"
}
Response
{
"data": {
"backupId": "backup_def456",
"label": "Before update",
"success": true
}
}
Errors
| Status |
Code |
Description |
| 404 |
NOT_FOUND |
VPS not found or not accessible |
| 409 |
NO_SLOTS |
No backup slots available |
| 502 |
PROVIDER_ERROR |
Upstream provider error |
Example
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"label": "Before update"}'
MCP
This action is also available via the create_backup MCP tool.