tools.ozone.moderation.queryEvents

List moderation events related to a subject.

Details · query
Kindquery
Authoritymoderation.ozone.tools
Indexed

Query

query · GET

Parameters

query string

If specified, only events where all of these labels were added are returned

itemsstring

If specified, only events where all of these tags were added are returned

itemsstring

If specified, only events where the age assurance state matches the given value are returned

  • knownValues: pending | assured | unknown | reset | blocked

batchId

string

If specified, only events where the batchId matches the given value are returned

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.

  • maxLength: 20
itemsstring · nsid

comment

string

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

Retrieve events created after a given timestamp

createdBefore

string · datetime

Retrieve events created before a given timestamp

createdBy

string · did

cursor

string

hasComment

boolean

If true, only events with comments are returned

If true, events on all record types (posts, lists, profile etc.) or records from given 'collections' param, owned by the did are returned.

  • default: false

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

modTool

array

If specified, only events where the modTool name matches any of the given values are returned

itemsstring
itemsstring

If specified, only events where the action policies match any of the given policies are returned

If specified, only events where all of these labels were removed are returned

itemsstring

If specified, only events where all of these tags were removed are returned

itemsstring
itemsstring

Sort direction for the events. Defaults to descending order of created at timestamp.

  • default: "desc"
  • enum: asc | desc

subject

string · uri

If specified, only events where the subject is of the given type (account, record, or conversation) 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 | conversation

types

array

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.

itemsstring

withStrike

boolean

If specified, only events where strikeCount value is set are returned.

Output

application/json

cursor

string

events

requiredarray

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • View moderation statuses of subjects (record or repo).

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

  • Global audit journal browser for the moderation console. Returns moderation_audit rows in reverse-chronological (created_at, id) keyset order, optionally filtered by acting moderator, action type, or subject DID. Complements getSubjectModerationHistory (per-subject view) with the 'what has the team been doing' view. Requires the caller to be an active moderator.

  • Get timeline of all available events of an account. This includes moderation events, account history and did history.

  • List subjects belonging to the authenticated account that have moderation actions from this moderation service.