tools.ozone.report.queryReports

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

class atproto_client.models.tools.ozone.report.query_reports.Params

Bases: ParamsModelBase

Parameters model for tools.ozone.report.queryReports.

field assigned_to: Did | None = None
field collections: List[Nsid] | None = None
Constraints:
  • max_length = 20

field cursor: str | None = None

Cursor.

field did: Did | None = None
field is_muted: bool | None = False
field limit: int | None = None

Limit.

Constraints:
  • ge = 1

  • le = 100

field queue_id: int | None = None

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

field report_types: List[str] | None = None
field reported_after: DateTime | None = None

Retrieve reports created after a given timestamp.

field reported_before: DateTime | None = None

Retrieve reports created before a given timestamp.

field sort_direction: Literal['asc', 'desc'] | None = 'desc'

Sort direction.

field sort_field: Literal['createdAt', 'updatedAt'] | None = 'createdAt'

Sort field.

field status: Literal['open', 'closed', 'escalated', 'queued', 'assigned'] | str [Required]

Filter by report status.

field subject: Uri | None = None

Filter by subject DID or AT-URI.

field subject_type: Literal['account', 'record', 'message', 'conversation'] | str | None = None
class atproto_client.models.tools.ozone.report.query_reports.ParamsDict

Bases: TypedDict

status: Literal['open', 'closed', 'escalated', 'queued', 'assigned'] | str

Filter by report status.

assigned_to: NotRequired[Did | None]

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

collections: NotRequired[List[Nsid] | None]

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: NotRequired[str | None]

Cursor.

did: NotRequired[Did | None]

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.

is_muted: NotRequired[bool | None]

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

limit: NotRequired[int | None]

Limit.

queue_id: NotRequired[int | None]

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

report_types: NotRequired[List[str] | None]

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

reported_after: NotRequired[DateTime | None]

Retrieve reports created after a given timestamp.

reported_before: NotRequired[DateTime | None]

Retrieve reports created before a given timestamp.

sort_direction: NotRequired[Literal['asc', 'desc'] | None]

Sort direction.

sort_field: NotRequired[Literal['createdAt', 'updatedAt'] | None]

Sort field.

subject: NotRequired[Uri | None]

Filter by subject DID or AT-URI.

subject_type: NotRequired[Literal['account', 'record', 'message', 'conversation'] | str | None]

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

class atproto_client.models.tools.ozone.report.query_reports.Response

Bases: ResponseModelBase

Output data model for tools.ozone.report.queryReports.

field cursor: str | None = None

Cursor.

field reports: List[models.ToolsOzoneReportDefs.ReportView] [Required]

Reports.