List moderation events related to a subject.
Parameters
addedLabels
array
of string
Optional
If specified, only events where all of these labels were added are returned
addedTags
array
of string
Optional
If specified, only events where all of these tags were added are returned
ageAssuranceState
string
Optional
If specified, only events where the age assurance state matches the given value are returned
batchId
string
Optional
If specified, only events where the batchId matches the given value are returned
collections
array
of string
Optional
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.
comment
string
Optional
If specified, only events with comments containing the keyword are returned. Apply || separator to use multiple keywords and match using OR condition.
createdAfter
string
datetime
Optional
Retrieve events created after a given timestamp
createdBefore
string
datetime
Optional
Retrieve events created before a given timestamp
createdBy
string
did
Optional
A decentralized identifier (DID).
cursor
string
Optional
No description available.
hasComment
boolean
Optional
If true, only events with comments are returned
includeAllUserRecords
boolean
Optional
If true, events on all record types (posts, lists, profile etc.) or records from given 'collections' param, owned by the did are returned.
limit
integer
Optional
No description available.
modTool
array
of string
Optional
If specified, only events where the modTool name matches any of the given values are returned
policies
array
of string
Optional
No description available.
removedLabels
array
of string
Optional
If specified, only events where all of these labels were removed are returned
removedTags
array
of string
Optional
If specified, only events where all of these tags were removed are returned
reportTypes
array
of string
Optional
No description available.
sortDirection
string
Optional
Sort direction for the events. Defaults to descending order of created at timestamp.
subject
string
uri
Optional
A valid URI.
subjectType
string
Optional
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.
types
array
of string
Optional
The types of events (fully qualified string in the format of tools.ozone.moderation.defs#modEvent<name>) to filter by. If not specified, all events are returned.
withStrike
boolean
Optional
If specified, only events where strikeCount value is set are returned.
Output
application/jsoncursor
string
Optional
No description available.
events
array
Required
No description available.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "query",
"output": {
"schema": {
"type": "object",
"required": [
"events"
],
"properties": {
"cursor": {
"type": "string"
},
"events": {
"type": "array",
"items": {
"ref": "tools.ozone.moderation.defs#modEventView",
"type": "ref"
}
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "The types of events (fully qualified string in the format of tools.ozone.moderation.defs#modEvent<name>) to filter by. If not specified, all events are returned."
},
"cursor": {
"type": "string"
},
"batchId": {
"type": "string",
"description": "If specified, only events where the batchId matches the given value are returned"
},
"comment": {
"type": "string",
"description": "If specified, only events with comments containing the keyword are returned. Apply || separator to use multiple keywords and match using OR condition."
},
"modTool": {
"type": "array",
"items": {
"type": "string"
},
"description": "If specified, only events where the modTool name matches any of the given values are returned"
},
"subject": {
"type": "string",
"format": "uri"
},
"policies": {
"type": "array",
"items": {
"type": "string",
"description": "If specified, only events where the action policies match any of the given policies are returned"
}
},
"addedTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "If specified, only events where all of these tags were added are returned"
},
"createdBy": {
"type": "string",
"format": "did"
},
"hasComment": {
"type": "boolean",
"description": "If true, only events with comments are returned"
},
"withStrike": {
"type": "boolean",
"description": "If specified, only events where strikeCount value is set are returned."
},
"addedLabels": {
"type": "array",
"items": {
"type": "string"
},
"description": "If specified, only events where all of these labels were added are returned"
},
"collections": {
"type": "array",
"items": {
"type": "string",
"format": "nsid"
},
"maxLength": 20,
"description": "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."
},
"removedTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "If specified, only events where all of these tags were removed are returned"
},
"reportTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"subjectType": {
"type": "string",
"description": "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.",
"knownValues": [
"account",
"record"
]
},
"createdAfter": {
"type": "string",
"format": "datetime",
"description": "Retrieve events created after a given timestamp"
},
"createdBefore": {
"type": "string",
"format": "datetime",
"description": "Retrieve events created before a given timestamp"
},
"removedLabels": {
"type": "array",
"items": {
"type": "string"
},
"description": "If specified, only events where all of these labels were removed are returned"
},
"sortDirection": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "desc",
"description": "Sort direction for the events. Defaults to descending order of created at timestamp."
},
"ageAssuranceState": {
"type": "string",
"description": "If specified, only events where the age assurance state matches the given value are returned",
"knownValues": [
"pending",
"assured",
"unknown",
"reset",
"blocked"
]
},
"includeAllUserRecords": {
"type": "boolean",
"default": false,
"description": "If true, events on all record types (posts, lists, profile etc.) or records from given 'collections' param, owned by the did are returned."
}
}
},
"description": "List moderation events related to a subject."
}