User Reports

Let your users report content and other users, and triage those reports in Lasso or act on them automatically with rules.

User reports are reports your own users file about a piece of content or about another user on your platform. Your product sends each report to Lasso through the API, and they show up on the User Reports page for your moderators to triage. Reports are also a signal for custom moderation rules, so you can automatically flag or remove something once enough people have reported it.

Lasso does not provide a report button or a reporting form. You build the reporting experience in your own product, and send every report to Lasso through the user reports endpoint.

What you can use them for

• Give moderators a queue of everything your community is complaining about, next to what your automated moderation catches.

• Escalate on volume, for example hide content once 3 different users have reported it within 24 hours.

• Trust some reporters more than others, so a report from a moderator or a trusted user can be acted on immediately while a report from a normal user needs corroboration.

• Catch bad-faith mass reporting by looking at how many reports a user has filed.

• Track what your users report, and how fast your team resolves it, in the analytics.

Before you start

Two things need to be in place before your product can send reports.

1. An API key. Create one under Settings → API & Webhooks. Reports are sent with the same key as the rest of the API.

2. At least one policy category enabled for user reports. Every report has to name a policy category, which is the reason the user picked ("Spam", "Harassment", and so on). Go to Policies, open a policy category and tick the User Reports checkbox: "Can this policy category be selected when users are reporting content or other users?". This is off by default, so a fresh workspace has no reasons your users can pick from.

While you are there, fill in the Information field of each of these categories. It is meant as guidance for the reporter: "This information helps users understand when to select this policy category while submitting a user report." It is returned by the API together with the category name, so you can show it in your report dialog.

Fetching the report reasons

GET /api/v1/user-reports returns the list of reasons your users can choose from, so your report dialog stays in sync with the dashboard instead of hardcoding a list. Only categories that are enabled and have User Reports ticked are returned.

{
  "success": true,
  "policies": [
    {
      "id": "harassment",
      "name": "Harassment",
      "description": "Targeted abuse or bullying of another user."
    }
  ]
}

The id here is the Policy Category ID (also shown as a column on the Policies page). That is the value you send back as policy_id when the user submits the report. If your workspace has translations enabled, each category also carries a translations object with the name and description per language.

Sending a report

POST /api/v1/user-reports records one report. Everything goes inside a report object:

Field	Required	Description
policy_id	Yes	The Policy Category ID of the reason the user picked, for example harassment.
reported_by_id	Yes	Your own id of the user filing the report. Max 100 characters.
content_id	One of	Your own id of the reported content.
user_id	One of	Your own id of the reported user.
reported_by_type	No	The type of the reporter: normal, trusted, moderator, admin or testing. Defaults to the type Lasso already has for that user.
extra_info	No	Free text the reporter added, shown to your moderators next to the report.

{
  "report": {
    "policy_id": "harassment",
    "reported_by_id": "user-456",
    "content_id": "comment-123",
    "extra_info": "Keeps calling me names in this thread"
  }
}

A successful call returns { "success": true }.

Things worth knowing:

• Send either content_id or user_id, never both and never neither. Both cases return a 400.

• The reported content must already exist in Lasso. If Lasso does not know the content id you get a 404 with Reported Content not found, so sync your content before you allow it to be reported.

• The reported user and the reporter are created automatically if Lasso has not seen them yet. They appear as "Unknown" until you sync their real profile.

• An unknown policy_id returns a 400 with Policy not found. Use the identifier, not the display name.

• Reports are not deduplicated. The same user reporting the same item twice creates two reports. If you only want one report per user per item, enforce that in your own product.

• If the reported user or content is already hidden in Lasso, the report is stored as handled straight away and never reaches your moderators' open list.

The endpoint is rate limited to 100 requests per minute per workspace. See rate limits for the response headers and retry behaviour. Full request and response details are in the API reference.

Handling reports in the dashboard

Reports land on the User Reports page in the sidebar. It has two tabs, Content and Users, each with the number of open reports. The Users tab is only visible to moderators with permission to see user reports.

Each row shows the reported item, its current status, when the report came in, the policy category the reporter picked, their extra information, who reported it, how many times the item has been reported in total, and, once resolved, who handled it.

From a row a moderator can:

• Take a moderation action on the reported content or user, with the same action buttons used elsewhere in the dashboard. The report is resolved automatically as soon as a decision is made.

• Ignore the report when nothing is wrong with the reported item.

• Ignore all reports for this content (or for this user) to clear every open report on the same item at once.

• Select several rows and use the Ignore n reports button to clear them in bulk.

By default the page only shows open reports. Tick Show handled reports to include the ones that are already resolved. Resolved rows carry an icon showing how they were closed: a green check when an action was taken, and a crossed-out eye when the report was ignored.

Reports resolve themselves whenever a moderator or a rule takes a final decision on the reported item. Allowing or removing content or a user marks every open report on it as handled and records which action did it. Flagging is not a final decision, so flagged items keep their reports open until someone decides.

Every report also appears in the activity timeline of the reported user or content, as "Reported by user for policy", together with the extra information the reporter sent.

Reacting to reports with rules

A report triggers a re-evaluation of your custom moderation rules on the reported user or content, so a rule can act on it within seconds. The report conditions are grouped under Reports in the condition list:

• Content # of Times Reported and User # of Times Reported: compare the number of reports against a number you set. You can count by unique users or in total, over all time or over period with a window like the last 24 hours, and restrict which reporter types count. For example, hide content reported by 3 or more unique users in the last 24 hours.

• Content Reported By and User Reported By: check whether the report came from a given type of user. A report from a moderator or an admin can be acted on immediately.

• # of Reports Made By User: available on user rules, compares how many reports a user has filed. Useful for catching users who mass-report others in bad faith.

The counting conditions look at every report ever filed on the item, including reports that were already handled or ignored.

Rules are also the link between reports and review queues. Reports do not create reviews by themselves, but a rule that flags a reported item will put it in front of your moderators through the normal routing rules.

Reports in analytics

Analytics → Reports shows how reporting behaves over time: Reports by Type (content versus users), Reports by Policy, Top Reporters, Average Handling Time and Reports by Decision, which splits resolved reports into accepted (the item was removed), rejected (the item was allowed) and ignored. Analytics are updated asynchronously, so very recent reports can take a moment to appear.

The users list also has # Reported and # Reports Made columns, so you can sort your user base by who gets reported most and who reports most.

Reports and webhooks

There is no separate webhook for an incoming report, because a report on its own is not a moderation decision. What your platform receives is the outcome: when a rule or a moderator acts on a reported item, the usual action webhook is sent with the policy category and the rule that caused it. That keeps your platform in sync with what actually happened, rather than with every complaint your users file.