Backups API

The Backups API provides endpoints for creating, listing, and restoring server backups.

Base URL

https://api.caforahost.com/v1

Endpoints

List Backups

GET /v1/servers/{server_id}/backups

Returns a list of available backups for the server.

Create Backup

POST /v1/servers/{server_id}/backups

Creates a new backup. The server must be running.

Restore Backup

POST /v1/servers/{server_id}/backups/{backup_id}/restore

Restores a backup. The server must be stopped.

Restoring a backup overwrites the current server state. This action cannot be undone.

Delete Backup

DELETE /v1/servers/{server_id}/backups/{backup_id}

Deletes a specific backup.

Example: Create Backup

import requests

headers = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    f"https://api.caforahost.com/v1/servers/{SERVER_ID}/backups",
    headers=headers
)

if response.status_code == 200:
    backup = response.json()
    print(f"Backup created: {backup['id']}")