Backup API

Create, restore, and manage configuration backups.

Endpoints

List Backups

GET /api/v1/backup/list

Create Backup

POST /api/v1/backup/create

{
  "name": "pre-migration",
  "scope": "full",
  "description": "Backup before major config change",
  "project_path": "/path/to/project"
}

Get Backup

GET /api/v1/backup/{backup_id}

Get Contents

GET /api/v1/backup/{backup_id}/contents

Returns list of files in the backup archive.

Get Manifest

GET /api/v1/backup/{backup_id}/manifest

Returns full metadata including dependencies and component lists.

Get Restore Plan

GET /api/v1/backup/{backup_id}/plan?project_path={path}

Analyzes what will be restored and identifies missing dependencies.

Validate Backup

POST /api/v1/backup/{backup_id}/validate

Download

GET /api/v1/backup/{backup_id}/download

Returns the ZIP archive file.

Restore

POST /api/v1/backup/{backup_id}/restore?project_path={path}

Install Dependencies

POST /api/v1/backup/{backup_id}/install-dependencies

{ "npm": true, "pip": true, "plugins": true }

Delete

DELETE /api/v1/backup/{backup_id}

Export Config

POST /api/v1/backup/export

{
  "paths": ["~/.claude/settings.json", "~/.claude/agents/"],
  "name": "settings-export"
}