AI insights

On Pro+ plans, Formspring generates a weekly digest of your inbox using a moderation model. The digest produces:

• Spam reasons — what flagged what, ranked by frequency
• Categories — clusters of submissions by topic
• Score distribution — bucketed AI moderation scores so you can spot outliers
• A free-text summary — "Last week 230 submissions, mostly support questions, with a 4% bump in spam from a single IP range"

The page lives at /ai-insights and refreshes weekly. You can also trigger a regeneration from the UI or via MCP — the regeneration job is idempotency-locked for 5 minutes to prevent duplicate runs.

Triggering a regeneration

• UI: Regenerate button on the insights page.
• REST API: POST /api/v1/ai-insights/regenerate (requires insights:write). Returns 202 on queue, 409 if already running.
• MCP: regenerate_ai_insights tool.

Reading insights via API / MCP

curl -H "Authorization: Bearer $TOKEN" \
  https://formspring.io/api/v1/ai-insights

→ returns either the insights payload or 423 Locked if your plan doesn't include AI features.

What's next

• Autoresponder drafts →
• Weekly digest emails →
• Categorization →