Skip to main content

tools.ozone.moderation.queryStatuses

GET 
/xrpc/tools.ozone.moderation.queryStatuses

This endpoint is part of the Ozone moderation service APIs. Requests usually require authentication, are directed to the user's PDS intance, and proxied to the Ozone instance indicated by the DID in the service proxying header. Admin authenentication may also be possible, with request sent directly to the Ozone instance.

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

View moderation statuses of subjects (record or repo).

Request​

Query Parameters

    includeAllUserRecords boolean

    All subjects, or subjects from given 'collections' param, belonging to the account specified in the 'subject' param will be returned.

    subject uri

    The subject to get the status for.

    comment string

    Search subjects by keyword from comments

    reportedAfter date-time

    Search subjects reported after a given timestamp

    reportedBefore date-time

    Search subjects reported before a given timestamp

    reviewedAfter date-time

    Search subjects reviewed after a given timestamp

    reviewedBefore date-time

    Search subjects reviewed before a given timestamp

    includeMuted boolean

    By default, we don't include muted subjects in the results. Set this to true to include them.

    onlyMuted boolean

    When set to true, only muted subjects and reporters will be returned.

    reviewState string

    Specify when fetching subjects in a certain state

    ignoreSubjects uri[]
    lastReviewedBy did

    Get all subject statuses that were reviewed by a specific moderator

    sortField string

    Default value: lastReportedAt

    sortDirection string

    Default value: desc

    takendown boolean

    Get subjects that were taken down

    appealed boolean

    Get subjects in unresolved appealed status

    limit integer

    Possible values: >= 1 and <= 100

    Default value: 50

    tags string[]
    excludeTags string[]
    cursor string
    collections nsid[]

    Possible values: <= 20

    If specified, subjects belonging to the given collections will be returned. When subjectType is set to 'account', this will be ignored.

    subjectType string

    Possible values: [account, record]

    If specified, subjects of the given type (account or record) will be returned. When this is set to 'account' the 'collections' parameter will be ignored. When includeAllUserRecords or subject is set, this will be ignored.

Responses​

OK

Schema

    cursor string

    subjectStatuses

    object[]

    required

  • Array [

    • id integerrequired

    subject

    object

    required

    oneOf

    did didrequired
    subjectBlobCids cid[]
    subjectRepoHandle string
    updatedAt date-timerequired

    Timestamp referencing when the last update was made to the moderation status of the subject

    createdAt date-timerequired

    Timestamp referencing the first moderation status impacting event was emitted on the subject

    reviewState tools.ozone.moderation.defs.subjectReviewStaterequired

    Possible values: [#reviewOpen, #reviewEscalated, #reviewClosed, #reviewNone]

    comment string

    Sticky comment on the subject.

    muteUntil date-time
    muteReportingUntil date-time
    lastReviewedBy did
    lastReviewedAt date-time
    lastReportedAt date-time
    lastAppealedAt date-time

    Timestamp referencing when the author of the subject appealed a moderation action

    takendown boolean
    appealed boolean

    True indicates that the a previously taken moderator action was appealed against, by the author of the content. False indicates last appeal was resolved by moderators.

    suspendUntil date-time
    tags string[]

  • ]

Loading...