Add vault-backed Karakeep API helper

This commit is contained in:
Fizzlepoof
2026-05-15 17:44:30 +00:00
parent 308ac205fb
commit 3aad8d037b
2 changed files with 155 additions and 0 deletions

View File

@@ -12,6 +12,22 @@ This directory includes repo-side helpers for homelab operational tasks.
See `docs/operations/KITCHENOWL_RECIPE_IMPORT.md` for setup and usage.
## Karakeep API helper
- `bin/karakeep_api.py` — tiny Karakeep REST helper backed by the local encrypted vault entry
- reads `.secrets/karakeep_secrets.json.enc`
- uses `baseUrl` + `apiKey`
- targets `/api/v1/...` routes by default
- supports ad hoc GET/POST/PATCH/DELETE calls with query/body args
Examples:
```bash
automation/bin/karakeep_api.py bookmarks --query limit=5 --pretty
automation/bin/karakeep_api.py tags --pretty
automation/bin/karakeep_api.py /api/health --raw-path --pretty
```
## Backup scripts
- `bin/pd_backup_postgres.sh` — creates gzipped `pg_dump` exports for the configured Postgres DB list (quote space-separated DB names in `.env`, e.g. `POSTGRES_DB_LIST="n8n paperless"`)