How the casebook rules

A casebook match always rules allow or reject — never review. Whatever it can’t settle goes to your review inbox as usual, so the casebook only ever removes work, never hides it.

​

Two ways to a ruling

• Recognition. The exact message has been ruled on before, so the same ruling applies without a review.
• Agreement among close cases. The content is very similar to several existing cases, and enough of them agree — “96% of its close cases agree, and that is enough to rule.”

Every ruling shows its evidence: the closest cases, each with a similarity percentage, its ruling, who decided it, and its topic.

​

Cases vote only on what they were flagged for

A case’s ruling is scoped by the labels your policies flagged on it. A rejection flagged for spam only counts as precedent for content flagged for spam — in a lookup’s evidence, a case that didn’t participate reads sat out — flags differ, and one that’s too far off reads not close enough to count. This is what makes corrected resubmissions safe: content close to rejected cases but missing the flag that got them rejected goes to a person instead of inheriting the rejection.

​

Cautious in one direction

Overriding your policies takes more evidence than agreeing with them. The casebook is quick to learn rules that are stricter than your policies — things your team rejects that they let through — and deliberately slow to allow content they flagged hard.

​

When it declines to rule

Declining is a feature, not a failure. The casebook sends content to review when: When evidence is thin, the result shows how far along the casebook is — “58% of the way to ruling on its own” — so you know a few more decisions will settle content like this. If the casebook can’t answer within its time budget, moderation simply proceeds without it. It can only ever add a ruling, never delay one.

​

Test your casebook

Look up on the Casebook page opens a test dialog: paste any message, pick a channel, and see how your casebook would rule — the verdict, what your policies flagged, and the closest cases. Testing never teaches it anything. When the lookup finds nothing, Add this as a case teaches the decision on the spot.

​

Precedent while you review

In the item detail view, a Casebook tab sits at the right edge. Pull it out and it shows what your casebook makes of the item on screen — the same answer the lookup gives, with each case one click from the item it was decided on. Leave it out and it answers for every item you open. It reads and never writes: your queue decisions are still what the casebook learns from.

​

In the API response

When the casebook has a verdict for a request, the moderation response carries a casebook object — the verdict, how close and how unanimous the supporting cases were, and the topic they belong to. See checking the casebook for the field reference and code examples. Whether the verdict was enforced depends on the channel’s Casebook lookup rule — when it was, recommendation.reason_codes contains casebook_match, and the item shows Casebook lookup as its outcome in the dashboard.