tools.ozone.moderation.query Statuses
GET {{baseUrl}}/xrpc/tools.ozone.moderation.queryStatuses?includeAllUserRecords=<boolean>&subject=<uri>&comment=<string>&reportedAfter=<dateTime>&reportedBefore=<dateTime>&reviewedAfter=<dateTime>&hostingDeletedAfter=<dateTime>&hostingDeletedBefore=<dateTime>&hostingUpdatedAfter=<dateTime>&hostingUpdatedBefore=<dateTime>&hostingStatuses=<string>&hostingStatuses=<string>&reviewedBefore=<dateTime>&includeMuted=<boolean>&onlyMuted=<boolean>&reviewState=<string>&ignoreSubjects=<uri>&ignoreSubjects=<uri>&lastReviewedBy=<did>&sortField=lastReportedAt&sortDirection=desc&takendown=<boolean>&appealed=<boolean>&limit=50&tags=<string>&tags=<string>&excludeTags=<string>&excludeTags=<string>&cursor=<string>&collections=<nsid>&collections=<nsid>&subjectType=<string>
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 Params
| Key | Datatype | Required | Description |
|---|---|---|---|
includeAllUserRecords | string | All subjects, or subjects from given 'collections' param, belonging to the account specified in the 'subject' param will be returned. | |
subject | string | The subject to get the status for. | |
comment | string | Search subjects by keyword from comments | |
reportedAfter | string | Search subjects reported after a given timestamp | |
reportedBefore | string | Search subjects reported before a given timestamp | |
reviewedAfter | string | Search subjects reviewed after a given timestamp | |
hostingDeletedAfter | string | Search subjects where the associated record/account was deleted after a given timestamp | |
hostingDeletedBefore | string | Search subjects where the associated record/account was deleted before a given timestamp | |
hostingUpdatedAfter | string | Search subjects where the associated record/account was updated after a given timestamp | |
hostingUpdatedBefore | string | Search subjects where the associated record/account was updated before a given timestamp | |
hostingStatuses | string | Search subjects by the status of the associated record/account | |
hostingStatuses | string | Search subjects by the status of the associated record/account | |
reviewedBefore | string | Search subjects reviewed before a given timestamp | |
includeMuted | string | By default, we don't include muted subjects in the results. Set this to true to include them. | |
onlyMuted | string | When set to true, only muted subjects and reporters will be returned. | |
reviewState | string | Specify when fetching subjects in a certain state | |
ignoreSubjects | string | ||
ignoreSubjects | string | ||
lastReviewedBy | string | Get all subject statuses that were reviewed by a specific moderator | |
sortField | string | ||
sortDirection | string | ||
takendown | string | Get subjects that were taken down | |
appealed | string | Get subjects in unresolved appealed status | |
limit | number | ||
tags | string | ||
tags | string | ||
excludeTags | string | ||
excludeTags | string | ||
cursor | string | ||
collections | string | If specified, subjects belonging to the given collections will be returned. When subjectType is set to 'account', this will be ignored. | |
collections | string | If specified, subjects belonging to the given collections will be returned. When subjectType is set to 'account', this will be ignored. | |
subjectType | string | 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. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"subjectStatuses":[{"id":"\u003cinteger\u003e","subject":{"did":"\u003cdid\u003e"},"createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","reviewState":"\u003cstring\u003e","hosting":{"status":"\u003cstring\u003e","updatedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","deletedAt":"\u003cdateTime\u003e","deactivatedAt":"\u003cdateTime\u003e","reactivatedAt":"\u003cdateTime\u003e"},"subjectBlobCids":["\u003ccid\u003e","\u003ccid\u003e"],"subjectRepoHandle":"\u003cstring\u003e","comment":"\u003cstring\u003e","muteUntil":"\u003cdateTime\u003e","muteReportingUntil":"\u003cdateTime\u003e","lastReviewedBy":"\u003cdid\u003e","lastReviewedAt":"\u003cdateTime\u003e","lastReportedAt":"\u003cdateTime\u003e","lastAppealedAt":"\u003cdateTime\u003e","takendown":"\u003cboolean\u003e","appealed":"\u003cboolean\u003e","suspendUntil":"\u003cdateTime\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"]},{"id":"\u003cinteger\u003e","subject":{"did":"\u003cdid\u003e"},"createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","reviewState":"\u003cstring\u003e","hosting":{"status":"\u003cstring\u003e","updatedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","deletedAt":"\u003cdateTime\u003e","deactivatedAt":"\u003cdateTime\u003e","reactivatedAt":"\u003cdateTime\u003e"},"subjectBlobCids":["\u003ccid\u003e","\u003ccid\u003e"],"subjectRepoHandle":"\u003cstring\u003e","comment":"\u003cstring\u003e","muteUntil":"\u003cdateTime\u003e","muteReportingUntil":"\u003cdateTime\u003e","lastReviewedBy":"\u003cdid\u003e","lastReviewedAt":"\u003cdateTime\u003e","lastReportedAt":"\u003cdateTime\u003e","lastAppealedAt":"\u003cdateTime\u003e","takendown":"\u003cboolean\u003e","appealed":"\u003cboolean\u003e","suspendUntil":"\u003cdateTime\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"]}],"cursor":"\u003cstring\u003e"}