Docs & quickstart

Quickstart

pip install flask cryptography
export CAREFORM_ENCRYPTION_KEY=$(python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())")
export CAREFORM_ADMIN_TOKEN=$(python3 -c "import secrets; print(secrets.token_hex(32))")
python app.py   # http://127.0.0.1:5001
# Create a form (admin):  POST /api/forms  (X-Admin-Token)
# Submit (public):        POST /api/forms/<id>/submit
# Read inbox (admin):     GET  /api/forms/<id>/submissions

API reference

• POST /api/forms — create (admin). GET /api/forms — list (admin).
• GET /api/forms/{id} — public schema. POST /api/forms/{id}/submit — public, validated (422 on errors).
• GET /api/forms/{id}/submissions — decrypted inbox (admin). GET /api/templates — healthcare templates.
• Non-live forms reject submissions with 403 (BAA gate).
• Full reference: OPENAPI.md in the repo.

The complete reference (every endpoint/command with method, path, auth, and example request/response) ships as OPENAPI.md in the product repo.

Support

Questions? Contact us — a human reads every message.