Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Reports

When a user on your platform reports content, you send that report to Coop’s Report API. Coop uses this to create a moderation job, which gets routed to the appropriate review queue for a moderator to act on.

Reports are the primary way user-generated signals enter the moderation workflow. They carry the identity of the reporter, the content being reported, the reason for the report, and optional context like surrounding thread messages or the author’s recent activity.

What Coop does with a report

When your platform sends a report, Coop:

  1. Creates a moderation job for the reported item
  2. Evaluates any routing rules to determine which queue the job belongs in
  3. Routes the job to that queue (or the default queue if no rule matches)
  4. Makes the job available to the next available moderator in that queue

If reportedForReason.csam is true, the job is routed directly to the NCMEC queue rather than going through the normal routing rule evaluation. See Child Safety (NCMEC) for details.

Sending reports to Coop

Reports are submitted via POST /api/v1/report. For the full API schema (field definitions, types, and requirements), see the Report API reference.

Invalidating reports from a bad-faith reporter

If a single user on your platform is mass-flagging non-violating content and clogging the review queue, moderators with the EDIT_MRT_QUEUES permission can invalidate every pending report from that reporter via the “Invalidate reports” action on any report’s detail view in the Manual Review Tool.

By default the action is scoped to the current job: it strips this reporter’s entries from the job’s report history. If the job has no other reporters or report sources (for example, automated detectors) left afterwards, the job is removed from the queue. To instead sweep every pending job in your organization, tick “Apply across the whole organization” in the confirmation modal. Decided or closed jobs are never modified.

This is a one-shot operation, not a persistent blocklist: future reports from the same reporter will land normally and need to be invalidated again if the behavior continues. Address recurring bad-faith reporters by banning or silencing them at the platform layer.

Each invalidation emits a trace span on the server with the moderator who performed it, the targeted reporter, an optional reason, and the resulting counts; the span is the current source of truth for ad-hoc audit lookups.

Appeals

If a user wants to contest a moderation decision, that’s handled through the Appeals API, a separate flow from reports. See Appeals for details.