Backups

Runsite supports automated and manual backups for managed databases with one-click restore.

Supported databases

PostgreSQL
Redis

Creating a backup

POST /api/backups/{db_type}/{db_id}
Content-Type: application/json

{
  "is_weekly": false
}

Parameter	Values
`db_type`	`postgresql`, `redis`
`db_id`	Database instance UUID

Rate limit: 5 backups per minute per user.

Listing backups

GET /api/backups/{db_type}/{db_id}

Returns all backups for a specific database instance, ordered by creation time.

Backup details

GET /api/backups/{backup_id}

Response:

{
  "id": "uuid",
  "database_id": "uuid",
  "database_type": "postgresql",
  "status": "completed",
  "trigger": "manual",
  "size_bytes": 1048576,
  "is_weekly": false,
  "error_message": null,
  "created_at": "2026-03-20T10:00:00Z"
}

Restoring from a backup

POST /api/backups/{backup_id}/restore

Rate limit: 3 restores per minute.

Backup status

Status	Description
`pending`	Backup queued for processing
`in_progress`	Backup currently running
`completed`	Backup finished successfully
`failed`	Backup failed (check `error_message`)

Deleting a backup

DELETE /api/backups/{backup_id}