> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetch moderated reports
> Fetch content reports for spaces the current user moderates
export const SpaceReputationParams = ({variant = "context", field = "path"}) => {
const isUser = variant === "user";
return <>
Opt-in. Adds a spaceReputation number to each returned user,
scoped to a single space. Requires the reputation bundle.
The reputation total is always present regardless;{" "}
spaceReputation is purely additive and only appears when you
pass this object. This object is the primary form — it
replaces the deprecated flat props below. See the{" "}
Reputation data model for the
full contract.
{isUser ?
Which bucket to read. A space <uuid> reads that
space's bucket; "none" reads the
project-general (space-less) bucket.{" "}
"context" is rejected (400) on this
endpoint — there is no space context to derive. The empty string
and the legacy general / null aliases are
also rejected. Missing buckets read as 0.
:
Which bucket to read. One of: a space <uuid>{" "}
(that space's bucket), "none" (the
project-general, space-less bucket), or{" "}
"context" (the space derived from the
request context — resolved per-row on lists, or the single space on
member/team/conversation surfaces). The empty string and the legacy{" "}
general / null aliases are rejected (400).
Missing buckets read as 0.
}
Only honored when spaceId is an explicit space <uuid>.
When true, spaceReputation is the{" "}
subtree sum — the named space plus all of its
descendant spaces (the root space's own bucket included). Ignored for{" "}
"none"; not allowed with "context".
{isUser ?
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid> or "none" only —{" "}
"context" is rejected (400) on this endpoint.
:
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid>, "none", or{" "}
"context".
}
Deprecated — use{" "}
spaceReputation.includeDescendants instead. The flat form,
only honored alongside an explicit spaceReputationId <uuid>.
;
};
## Overview
Returns a function to fetch content reports (entities and comments) from spaces where the current user has an `admin` or `moderator` role.
If `spaceId` is provided, returns reports for that specific space (the user must moderate it). If omitted, returns reports aggregated from **all** spaces the user moderates.
Requires an authenticated user with `admin` or `moderator` role in at least one space.
## Usage Example
```tsx theme={null}
import { useFetchModeratedReports } from "@sublay/react-js";
import { useEffect, useState } from "react";
function ModerationQueue({ spaceId }: { spaceId: string }) {
const fetchModeratedReports = useFetchModeratedReports();
const [reports, setReports] = useState([]);
useEffect(() => {
fetchModeratedReports({ spaceId, status: "pending", page: 1, limit: 20 })
.then(res => setReports(res.data));
}, [spaceId]);
return (
{reports.map(r => (
- {r.targetType}: {r.reporterCount} reports
))}
);
}
```
## Parameters
Filter reports to a specific space. If omitted, returns reports from all spaces the user moderates.
Filter by target type.
Filter by report status.
Sort order. Defaults to `"new"` (newest first).
Page number for pagination. Defaults to `1`.
Items per page. Defaults to `20`.
## Returns
Returns `Promise>`:
```ts theme={null}
{
data: Report[];
pagination: {
page: number;
pageSize: number;
totalPages: number;
totalItems: number;
hasMore: boolean;
};
}
```
### Report object
UUID of the report record.
Project the report belongs to.
Space the reported content belongs to.
ID of the reported entity, comment, or chat message.
Type of the reported content.
Total number of users who have reported this target.
Individual user report entries. Each includes `id`, `userId`, `reason`, `details`, and `createdAt`.
Current moderation status: `pending`, `on-hold`, `escalated`, `dismissed`, or `actioned`.
Free-text description of action taken, if any.
The reported content record (includes the author user object). Populated even if the content was soft-deleted. When `spaceReputation` is requested, the embedded author carries an added `spaceReputation` number. See [Reputation](/v8/data-models/reputation).
The space the reported content belongs to.
When the first report for this target was submitted.
When the report record was last updated.
Soft-delete timestamp. `null` if the report has not been deleted.
## Notes
* Message reports appear in this queue only for conversations attached to a space. DM and group chat reports have no space, so they are project-level and appear only in the Sublay dashboard — see [`useCreateReport`](/v8/hooks/reports/use-create-report).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.