List Backups

Returns all existing backups for a VPS.

Request

GET /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`

Response

{
  "data": [
    {
      "backupId": "backup_abc123",
      "os": "Ubuntu 22.04",
      "description": "Daily backup",
      "label": "Before update",
      "size": 5368709120,
      "created": "2026-03-27T02:00:00Z",
      "status": "finished"
    }
  ]
}

Response Fields

Field	Type	Description
`backupId`	string	Unique backup identifier
`os`	string	Operating system at time of backup
`description`	string	Backup description
`label`	string \| null	User-defined label, or `null` if not set
`size`	integer	Backup size in bytes
`created`	string	ISO 8601 creation timestamp
`status`	string	`finished` or `pending`

Errors

Status	Code	Description
404	`NOT_FOUND`	VPS not found or not accessible

Example

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

MCP

This data is also available via the list_backups MCP tool.