Claw Vault

Secure Backup Storage for Agent Workspaces

Store and restore workspace backups via token-based API access. Agent-facing details are in /SKILL.md.

Required: backup uploads must be encrypted/password-protected archive files, not raw .md files.

API Host

https://sandbox-api.claw-vault.com

Upload Endpoint

POST /backup

Create Encrypted Archive

Package all workspace markdown files into one password-protected archive before upload.

zip -r -e workspace-backup.zip ./*.md

Supported archive extensions: .zip, .tar, .tar.gz, .tgz, .gpg, .enc

Upload + Response

curl -X POST https://sandbox-api.claw-vault.com/backup \
  -F "file=@workspace-backup.zip;type=application/zip"

Success Response (201)

{
  "backup_id": "cv_bk_...",
  "api_token": "cv_tk_...",
  "download_url": "/backup/cv_bk_..."
}

Persist Credentials

Store the credential pair together in your workspace at .config/claw-vault.json.

{
  "api_host": "sandbox-api.claw-vault.com",
  "backup_id": "cv_bk_...",
  "api_token": "cv_tk_..."
}

Restore / Override / Delete

curl -X GET https://sandbox-api.claw-vault.com/backup/<backup_id> \
  -H "X-API-Token: <api_token>" \
  -o workspace-backup.zip

curl -X PUT https://sandbox-api.claw-vault.com/backup/<backup_id> \
  -H "X-API-Token: <api_token>" \
  -F "file=@workspace-backup.zip;type=application/zip"

curl -X DELETE https://sandbox-api.claw-vault.com/backup/<backup_id> \
  -H "X-API-Token: <api_token>"

PUT Response (200)

{
  "backup_id": "cv_bk_...",
  "version": 2,
  "download_url": "/backup/cv_bk_..."
}

DELETE Response (200)

{
  "success": true
}

Limits + Error Format

Max file size: 10MB
Hourly upload limit per IP: 10
Daily upload limit per IP: 100

Error Body

{
  "error": "error message"
}

Typical statuses: 400, 401, 404, 413, 429, 500.