tools.ozone.report.queryReports

ozone-lexicons.bsky.social

Documentation

View moderation reports. Reports are individual instances of content being reported, as opposed to subject statuses which aggregate reports at the subject level.

main query

View moderation reports. Reports are individual instances of content being reported, as opposed to subject statuses which aggregate reports at the subject level.

Parameters

assignedTo string did Optional

Filter by the DID of the moderator permanently assigned to the report.

collections array of string Optional

If specified, reports where the subject belongs to the given collections will be returned. When subjectType is set to 'account', this will be ignored.

cursor string Optional

No description available.

did string did Optional

Filter to reports where the subject is this DID or any record owned by this DID. Unlike `subject` (which scopes to a specific account or record), this returns all reports tied to the DID across both account-level and record-level subjects.

isMuted boolean Optional

Filter by muted status. true returns only muted reports, false returns only unmuted reports. Defaults to false.

limit integer Optional

No description available.

queueId integer Optional

Filter by queue ID. Use -1 for unassigned reports.

reportTypes array of string Optional

Filter by report types (fully qualified string in the format of com.atproto.moderation.defs#reason<name>).

reportedAfter string datetime Optional

Retrieve reports created after a given timestamp

reportedBefore string datetime Optional

Retrieve reports created before a given timestamp

sortDirection string Optional

No description available.

sortField string Optional

No description available.

status string Required

Filter by report status.

subject string uri Optional

Filter by subject DID or AT-URI.

subjectType string Optional

If specified, reports of the given subject type will be returned.

Output

Encodingapplication/json
cursor string Optional

No description available.

reports array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Filter by the DID of the moderator permanently assigned to the report.
If specified, reports where the subject belongs to the given collections will be returned. When subjectType is set to 'account', this will be ignored.
Filter to reports where the subject is this DID or any record owned by this DID. Unlike `subject` (which scopes to a specific account or record), this returns all reports tied to the DID across both account-level and record-level subjects.
Filter by muted status. true returns only muted reports, false returns only unmuted reports. Defaults to false.
Filter by queue ID. Use -1 for unassigned reports.
Filter by report types (fully qualified string in the format of com.atproto.moderation.defs#reason<name>).
Retrieve reports created after a given timestamp
Retrieve reports created before a given timestamp
Filter by report status.
Filter by subject DID or AT-URI.
If specified, reports of the given subject type will be returned.
View raw schema
{
  "description": "View moderation reports. Reports are individual instances of content being reported, as opposed to subject statuses which aggregate reports at the subject level.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "type": "string"
        },
        "reports": {
          "items": {
            "ref": "tools.ozone.report.defs#reportView",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "reports"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "assignedTo": {
        "description": "Filter by the DID of the moderator permanently assigned to the report.",
        "format": "did",
        "type": "string"
      },
      "collections": {
        "description": "If specified, reports where the subject belongs to the given collections will be returned. When subjectType is set to 'account', this will be ignored.",
        "items": {
          "format": "nsid",
          "type": "string"
        },
        "maxLength": 20,
        "type": "array"
      },
      "cursor": {
        "type": "string"
      },
      "did": {
        "description": "Filter to reports where the subject is this DID or any record owned by this DID. Unlike `subject` (which scopes to a specific account or record), this returns all reports tied to the DID across both account-level and record-level subjects.",
        "format": "did",
        "type": "string"
      },
      "isMuted": {
        "default": false,
        "description": "Filter by muted status. true returns only muted reports, false returns only unmuted reports. Defaults to false.",
        "type": "boolean"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "queueId": {
        "description": "Filter by queue ID. Use -1 for unassigned reports.",
        "type": "integer"
      },
      "reportTypes": {
        "description": "Filter by report types (fully qualified string in the format of com.atproto.moderation.defs#reason<name>).",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "reportedAfter": {
        "description": "Retrieve reports created after a given timestamp",
        "format": "datetime",
        "type": "string"
      },
      "reportedBefore": {
        "description": "Retrieve reports created before a given timestamp",
        "format": "datetime",
        "type": "string"
      },
      "sortDirection": {
        "default": "desc",
        "enum": [
          "asc",
          "desc"
        ],
        "type": "string"
      },
      "sortField": {
        "default": "createdAt",
        "enum": [
          "createdAt",
          "updatedAt"
        ],
        "type": "string"
      },
      "status": {
        "description": "Filter by report status.",
        "knownValues": [
          "open",
          "closed",
          "escalated",
          "queued",
          "assigned"
        ],
        "type": "string"
      },
      "subject": {
        "description": "Filter by subject DID or AT-URI.",
        "format": "uri",
        "type": "string"
      },
      "subjectType": {
        "description": "If specified, reports of the given subject type will be returned.",
        "knownValues": [
          "account",
          "record",
          "message",
          "conversation"
        ],
        "type": "string"
      }
    },
    "required": [
      "status"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@