Skip to main content
GET
/
:projectId
/
api
/
v7
/
reports
/
moderated
Fetch Moderated Reports
curl --request GET \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/reports/moderated
Returns a paginated list of reports for spaces where the authenticated user has the admin or moderator role. If spaceId is omitted, reports from all spaces the user moderates are returned. Authentication required. Must be a space admin or moderator.

Query Parameters

spaceId
string
Filter to a specific space. The user must be an admin or moderator of that space. When omitted, reports from all moderated spaces are returned.
targetType
string
Filter by content type. One of: entity, comment.
status
string
Filter by report status. One of: pending, on-hold, escalated, dismissed, actioned.
sortBy
string
default:"new"
Sort order. One of: new (newest first), old (oldest first).
page
number
default:"1"
Page number (1-indexed).
limit
number
default:"20"
Number of reports per page.

Space-scoped reputation

This endpoint has a space in context, so it accepts the opt-in reputation params. They add a spaceReputation field to each reported content author’s populated user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model for the full contract.
spaceReputationId
string
Adds spaceReputation to each returned user. One of: a space <uuid> (that space’s bucket), none (the project-general bucket), or context (the space derived from this request’s context — per-row on lists). The empty string and the legacy general / null aliases are rejected (400). Missing buckets read as 0.
spaceReputationDescendants
boolean
Only honored with an explicit space <uuid>. When true, spaceReputation is the subtree sum — the space plus all of its descendants (the root space’s own bucket included). Ignored for none; not allowed with context.

Response

{
  "data": [
    {
      "id": "uuid",
      "targetId": "uuid",
      "targetType": "comment",
      "spaceId": "uuid",
      "status": "pending",
      "reporterCount": 3,
      "target": { ...Comment object... },
      "space": { ...Space object... },
      "userReports": [
        { "userId": "uuid", "reason": "spam", "details": "..." }
      ],
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalPages": 2,
    "totalItems": 35,
    "hasMore": true
  }
}
Each report includes the full reported content (target), the space it belongs to, and all individual user reports (userReports).

Error Responses

{ "error": "Moderator access required for this space", "code": "report/forbidden" }
Returned when spaceId is provided but the user is not a moderator of that space.