Migration

0.1.0 -> 0.2.0

Version 0.2.0 introduces a strict split between License API and Management API and changes how key authentication works.

What changed

  • New Management API routes under /management/* for API key and webhook configuration.
  • /generate and /revoke no longer accept env bootstrap keys.
  • Env auth config renamed from SERVER_API_KEYS / SERVER_API_KEY to MANAGEMENT_API_KEYS / MANAGEMENT_API_KEY.
  • Health endpoint now returns an explicit API version field.

1) Update environment variables

bash
# Before (0.1.0)
SERVER_API_KEYS=server_key_dev_123456

# After (0.2.0)
MANAGEMENT_API_KEYS=management_key_dev_123456

2) Create generated server API keys

Create at least one server key through the Management API, then use that generated key for /generate and /revoke.

bash
curl -sS http://localhost:8080/management/api-keys \
  -H "Authorization: Bearer management_key_dev_123456" \
  -H "Content-Type: application/json" \
  -d '{"name":"stripe-prod"}'

3) Update integrations and dashboards

  • Payment/webhook bridges should use generated server keys.
  • Internal operator UI should call /management/* with management auth.
  • Review docs links: License API is now separate from Management API pages.