Analytics

Product analytics and upgrade-intent tracking.

📄️ Track Upgrade Intent Event

Record an upgrade intent event such as a pricing click or a locked-feature attempt and return 201 with the stored event id. Authentication is optional: when a Bearer token is supplied, user_id, email and client_id are enriched from the JWT. Rate limited to 10 requests/minute and 1000/hour per IP.

📄️ List Upgrade Intent Events

Return a cursor-paginated collection of upgrade intent events filtered by date range (YYYY-MM-DD). Superadmins may filter by any email; regular users are always scoped to their own account. Returns 400 for invalid or inverted date ranges.

📄️ Check Upgrade Intent Notification

Report whether an upgrade_click event already exists for the caller's email and the given feature_value, returning already_notified and the latest notification timestamp. Superadmins may check an arbitrary email; other callers are scoped to their own account. Returns 400 when feature_value is missing.