tools.ozone.moderation.queryEvents
GET/xrpc/tools.ozone.moderation.queryEvents
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.
List moderation events related to a subject.
Request
Query Parameters
The types of events (fully qualified string in the format of tools.ozone.moderation.defs#modEvent
Default value: desc
Sort direction for the events. Defaults to descending order of created at timestamp.
Retrieve events created after a given timestamp
Retrieve events created before a given timestamp
Possible values: <= 20
If specified, only events where the subject belongs to the given collections will be returned. When subjectType is set to 'account', this will be ignored.
Possible values: [account
, record
]
If specified, only events where the subject is 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.
If true, events on all record types (posts, lists, profile etc.) or records from given 'collections' param, owned by the did are returned.
Possible values: >= 1
and <= 100
Default value: 50
If true, only events with comments are returned
If specified, only events with comments containing the keyword are returned
If specified, only events where all of these labels were added are returned
If specified, only events where all of these labels were removed are returned
If specified, only events where all of these tags were added are returned
If specified, only events where all of these tags were removed are returned
Responses
- 200
- 400
- 401
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
- tools.ozone.moderation.defs.modEventTakedown
- tools.ozone.moderation.defs.modEventReverseTakedown
- tools.ozone.moderation.defs.modEventComment
- tools.ozone.moderation.defs.modEventReport
- tools.ozone.moderation.defs.modEventLabel
- tools.ozone.moderation.defs.modEventAcknowledge
- tools.ozone.moderation.defs.modEventEscalate
- tools.ozone.moderation.defs.modEventMute
- tools.ozone.moderation.defs.modEventUnmute
- tools.ozone.moderation.defs.modEventMuteReporter
- tools.ozone.moderation.defs.modEventUnmuteReporter
- tools.ozone.moderation.defs.modEventEmail
- tools.ozone.moderation.defs.modEventResolveAppeal
- tools.ozone.moderation.defs.modEventDivert
- tools.ozone.moderation.defs.modEventTag
- com.atproto.moderation.defs.reasonSpam
- com.atproto.moderation.defs.reasonViolation
- com.atproto.moderation.defs.reasonMisleading
- com.atproto.moderation.defs.reasonSexual
- com.atproto.moderation.defs.reasonRude
- com.atproto.moderation.defs.reasonOther
- com.atproto.moderation.defs.reasonAppeal
- com.atproto.admin.defs.repoRef
- com.atproto.repo.strongRef
- chat.bsky.convo.defs.messageRef
]
events
object[]
required
event
object
required
oneOf
If true, all other reports on content authored by this account will be resolved (acknowledged).
Describe reasoning behind the reversal.
Make the comment persistent on the subject
Set to true if the reporter was muted from reporting at the time of the event. These reports won't impact the reviewState of the subject.
reportType
object
required
oneOf
string
string
string
string
string
string
string
Describe reasoning behind the reversal.
Describe reasoning behind the reversal.
The subject line of the email sent to the user.
The content of the email sent to the user.
Additional comment about the outgoing comm.
Describe resolution.
Additional comment about added/removed tags.
subject
object
required
oneOf
{
"cursor": "string",
"events": [
{
"id": 0,
"event": {},
"subject": {},
"subjectBlobCids": [
"string"
],
"createdBy": "string",
"createdAt": "2024-11-07T00:27:32.167Z",
"creatorHandle": "string",
"subjectHandle": "string"
}
]
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [InvalidRequest
, ExpiredToken
, InvalidToken
]
{
"error": "InvalidRequest",
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}