Skip to content

docs: blockedReason is operator-only, not returned via customer API#24

Open
tuyakhov wants to merge 1 commit into
mainfrom
claude/relaxed-cray-92eoea
Open

docs: blockedReason is operator-only, not returned via customer API#24
tuyakhov wants to merge 1 commit into
mainfrom
claude/relaxed-cray-92eoea

Conversation

@tuyakhov

Copy link
Copy Markdown
Contributor

Summary

One doc-worthy change since the last run (June 17): senderkit-app #211 removed blockedReason from all customer-facing message projections. The June 17 changelog entry and two other pages incorrectly described blockedReason as a customer-visible field with meaningful content.

Changes

  • changelog.mdx — Adds a June 19 entry clarifying that blockedReason is operator-only. Corrects the June 17 entry (removes the blockedReason description; replaces it with a note pointing to the June 19 correction).
  • sdks/typescript.mdx — Fixes the <Note> about blocked status: removes the claim that blockedReason explains the flag to customers; states instead that a generic timeline notice is what customers see.
  • concepts/messages.mdx — Fixes the blocked row in the lifecycle table: removes "The blockedReason field explains why" and replaces with "The message timeline records a generic notice; detection details are operator-only."

What changed in the product (senderkit-app #211)

lib/services/messages.ts now exports a messageColumns projection that explicitly excludes blockedReason from every customer-facing read (API list, API get, SSE tail, logs-page SSR). The customer-visible blocked timeline entry is "Blocked by automated content safety checks." The field value (credential_form: …, llm_suspicious: …, etc.) stays in the DB and the admin abuse console only.

PRs reviewed (since June 17)

Repo PR Status Doc impact
senderkit-app #211 fix(abuse): keep spam-detection detail out of customer-visible surfaces Merged June 19 Yes — this PR
senderkit-app #210 docs: spec + plan for Supabase MCP wiring Merged June 19 No (internal planning doc)
senderkit-app #209/#208 Admin abuse review UI Merged June 19 No (internal admin tooling)
senderkit-app #207 feat(onboarding): toggle checklist by title Merged June 19 No (UI micro-interaction)
senderkit-app #206 fix(abuse): don't flag loopback/private-IP links Merged June 19 No (internal behavior change)
senderkit-app #205 fix(abuse): de-dupe operator alert emails Merged June 19 No (operator-only)
senderkit-app #203 feat(logs): load older history under live tail Merged June 19 No (UI enhancement, no API change)
senderkit-app #202 fix(abuse): escape attacker-controlled reason Merged June 19 No (internal security fix)
senderkit-app #201 refactor(abuse): dedupe LLM classifier Merged June 18 No (internal refactor)
senderkit-app #200 feat(managed-ses): retune shared-sender caps Merged June 17 Already covered in June 16 changelog entry
senderkit-sdk #48 chore(deps): bump github-actions Merged June 19 No
senderkit-sdk #47 Version Packages Merged June 17 No

🤖 Generated with Claude Code

https://claude.ai/code/session_01L1Vn6uVk4YTQShZyH8j6oi


Generated by Claude Code

senderkit-app #211 removed blockedReason from all customer-facing message
projections (messages.list, messages.get, SSE tail, logs page). Customers
see only a generic "Blocked by automated content safety checks." timeline
entry; the detailed detection signal breakdown is operator-only.

The June 17 changelog entry and the SDK/concepts docs incorrectly described
blockedReason as a customer-visible field with meaningful content — corrected
across all three files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L1Vn6uVk4YTQShZyH8j6oi
@mintlify

mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
senderkit 🟢 Ready View Preview Jun 19, 2026, 10:33 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants