tools.ozone.moderation.defs
Details · defs
| Kind | defs |
|---|---|
| Authority | moderation.ozone.tools |
| Commit rev | 3n2oxkwjbx224 |
| Indexed |
Showing version bafyreidosfifnbi77vne6bvpt6rorp4w6jcqfoesfuj4dt5jchzs4xlt5y. Show the latest
#accountEvent
objectLogs account status related events on a repo subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.
#accountHosting
objectProperties
createdAt
string · datetimedeactivatedAt
string · datetimedeletedAt
string · datetimereactivatedAt
string · datetimeknownValues: takendown | suspended | deleted | deactivated | unknown
updatedAt
string · datetime#accountStrike
objectStrike information for an account
Properties
activeStrikeCount
integerCurrent number of active strikes (excluding expired strikes)
firstStrikeAt
string · datetimeTimestamp of the first strike received
lastStrikeAt
string · datetimeTimestamp of the most recent strike received
totalStrikeCount
integerTotal number of strikes ever received (including expired strikes)
#ageAssuranceEvent
objectAge assurance info coming directly from users. Only works on DID subjects.
Properties
access
refThe unique identifier for this instance of the age assurance flow, in UUID format.
completeIp
stringThe IP address used when completing the AA flow.
completeUa
stringThe user agent used when completing the AA flow.
countryCode
stringThe ISO 3166-1 alpha-2 country code provided when beginning the Age Assurance flow.
The date and time of this write operation.
initIp
stringThe IP address used when initiating the AA flow.
initUa
stringThe user agent used when initiating the AA flow.
regionCode
stringThe ISO 3166-2 region code provided when beginning the Age Assurance flow.
The status of the Age Assurance process.
knownValues: unknown | pending | assured
#ageAssuranceOverrideEvent
objectAge assurance status override by moderators. Only works on DID subjects.
Properties
access
refComment describing the reason for the override.
minLength: 1
The status to be set for the user decided by a moderator, overriding whatever value the user had previously. Use reset to default to original state.
knownValues: assured | reset | blocked
#ageAssurancePurgeEvent
objectPurges all age assurance events for the subject. Only works on DID subjects. Moderator-only.
Properties
Comment describing the reason for the purge.
minLength: 1
#blobView
objectProperties
#cancelScheduledTakedownEvent
objectLogs cancellation of a scheduled takedown action for an account.
Properties
comment
string#convoView
object#identityEvent
objectLogs identity related events on a repo subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.
#imageDetails
object#modEventAcknowledge
objectProperties
acknowledgeAccountSubjects
booleanIf true, all other reports on content authored by this account will be resolved (acknowledged).
comment
string#modEventComment
objectAdd a comment to a subject. An empty comment will clear any previously set sticky comment.
#modEventDivert
objectDivert a record's blobs to a 3rd party service for further scanning/tagging
Properties
comment
string#modEventEmail
objectKeep a log of outgoing email to a user
Properties
comment
stringAdditional comment about the outgoing comm.
content
stringThe content of the email sent to the user.
isDelivered
booleanIndicates whether the email was successfully delivered to the user's inbox.
policies
arrayNames/Keywords of the policies that necessitated the email.
maxLength: 5
severityLevel
stringSeverity level of the violation. Normally 'sev-1' that adds strike on repeat offense
strikeCount
integerNumber of strikes to assign to the user for this violation. Normally 0 as an indicator of a warning and only added as a strike on a repeat offense.
strikeExpiresAt
string · datetimeWhen the strike should expire. If not provided, the strike never expires.
The subject line of the email sent to the user.
#modEventEscalate
objectProperties
comment
string#modEventLabel
objectApply/Negate labels on a subject
Properties
comment
stringdurationInHours
integerIndicates how long the label will remain on the subject. Only applies on labels that are being added.
#modEventMute
objectMute incoming reports on a subject
Properties
comment
stringIndicates how long the subject should remain muted.
#modEventMuteReporter
objectMute incoming reports from an account
Properties
comment
stringdurationInHours
integerIndicates how long the account should remain muted. Falsy value here means a permanent mute.
#modEventPriorityScore
objectSet priority score of the subject. Higher score means higher priority.
#modEventReport
objectReport a subject
Properties
appealActionId
integerappealActionType
stringAction reference type recorded when this appeal was submitted.
appealLabel
stringappealSubmittedBy
string · didModerator who submitted this appeal on behalf of the affected account. Returned by moderator event APIs.
comment
stringisReporterMuted
booleanSet 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.
#modEventResolveAppeal
objectResolve appeal on a subject
Properties
comment
stringDescribe resolution.
#modEventReverseTakedown
objectRevert take down action on a subject
Properties
comment
stringDescribe reasoning behind the reversal.
policies
arrayNames/Keywords of the policy infraction for which takedown is being reversed.
maxLength: 5
severityLevel
stringSeverity level of the violation. Usually set from the last policy infraction's severity.
strikeCount
integerNumber of strikes to subtract from the user's strike count. Usually set from the last policy infraction's severity.
strikeExpiresAt
string · datetimeWhen the strike should expire. If not provided, the strike never expires.
#modEventTag
objectAdd/Remove a tag on a subject
Properties
Tags to be added to the subject. If already exists, won't be duplicated.
comment
stringAdditional comment about added/removed tags.
durationInHours
integerIndicates how long the tags being added should remain before automatically being removed. Only applies to tags being added.
Tags to be removed to the subject. Ignores a tag If it doesn't exist, won't be duplicated.
#modEventTakedown
objectTake down a subject permanently or temporarily
Properties
acknowledgeAccountSubjects
booleanIf true, all other reports on content authored by this account will be resolved (acknowledged).
comment
stringdurationInHours
integerIndicates how long the takedown should be in effect before automatically expiring.
policies
arrayNames/Keywords of the policies that drove the decision.
maxLength: 5
severityLevel
stringSeverity level of the violation (e.g., 'sev-0', 'sev-1', 'sev-2', etc.).
strikeCount
integerNumber of strikes to assign to the user for this violation.
strikeExpiresAt
string · datetimeWhen the strike should expire. If not provided, the strike never expires.
targetServices
arrayList of services where the takedown should be applied. If empty or not provided, takedown is applied on all configured services.
knownValues: appview | pds
#modEventUnmute
objectUnmute action on a subject
Properties
comment
stringDescribe reasoning behind the reversal.
#modEventUnmuteReporter
objectUnmute incoming reports from an account
Properties
comment
stringDescribe reasoning behind the reversal.
#modEventView
objectProperties
creatorHandle
string- #modEventTakedown
- #modEventReverseTakedown
- #modEventComment
- #modEventReport
- #modEventLabel
- #modEventAcknowledge
- #modEventEscalate
- #modEventMute
- #modEventUnmute
- #modEventMuteReporter
- #modEventUnmuteReporter
- #modEventEmail
- #modEventResolveAppeal
- #modEventDivert
- #modEventTag
- #accountEvent
- #identityEvent
- #recordEvent
- #modEventPriorityScore
- #ageAssuranceEvent
- #ageAssuranceOverrideEvent
- #ageAssurancePurgeEvent
- #revokeAccountCredentialsEvent
- #scheduleTakedownEvent
- #cancelScheduledTakedownEvent
subjectHandle
string#modEventViewDetail
objectProperties
- #modEventTakedown
- #modEventReverseTakedown
- #modEventComment
- #modEventReport
- #modEventLabel
- #modEventAcknowledge
- #modEventEscalate
- #modEventMute
- #modEventUnmute
- #modEventMuteReporter
- #modEventUnmuteReporter
- #modEventEmail
- #modEventResolveAppeal
- #modEventDivert
- #modEventTag
- #accountEvent
- #identityEvent
- #recordEvent
- #modEventPriorityScore
- #ageAssuranceEvent
- #ageAssuranceOverrideEvent
- #ageAssurancePurgeEvent
- #revokeAccountCredentialsEvent
- #scheduleTakedownEvent
- #cancelScheduledTakedownEvent
#modTool
objectModeration tool information for tracing the source of the action
#moderation
objectProperties
#moderationDetail
objectProperties
#recordEvent
objectLogs lifecycle event on a record subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.
#recordHosting
object#recordView
objectProperties
#recordViewDetail
objectProperties
#recordViewNotFound
objectProperties
#repoView
objectProperties
deactivatedAt
string · datetimeinviteNote
stringinvitedBy
refinvitesDisabled
booleanthreatSignatures
array#repoViewDetail
objectProperties
deactivatedAt
string · datetimeemailConfirmedAt
string · datetimeinviteNote
stringinvitedBy
refinvites
arrayinvitesDisabled
booleanlabels
arraythreatSignatures
array#repoViewNotFound
objectProperties
#reporterStats
objectProperties
The total number of reports made by the user on accounts.
The total number of accounts labeled as a result of the user's reports.
The total number of records labeled as a result of the user's reports.
The total number of reports made by the user on records.
The total number of accounts reported by the user.
The total number of records reported by the user.
The total number of accounts taken down as a result of the user's reports.
The total number of records taken down as a result of the user's reports.
#reviewClosed
tokenModerator review status of a subject: Closed. Indicates that the subject was already reviewed and resolved by a moderator
#reviewEscalated
tokenModerator review status of a subject: Escalated. Indicates that the subject was escalated for review by a moderator
#reviewNone
tokenModerator review status of a subject: Unnecessary. Indicates that the subject does not need a review at the moment but there is probably some moderation related metadata available for it
#reviewOpen
tokenModerator review status of a subject: Open. Indicates that the subject needs to be reviewed by a moderator
#revokeAccountCredentialsEvent
objectAccount credentials revocation by moderators. Only works on DID subjects.
Properties
Comment describing the reason for the revocation.
minLength: 1
#scheduleTakedownEvent
objectLogs a scheduled takedown action for an account.
Properties
comment
stringexecuteAfter
string · datetimeexecuteAt
string · datetimeexecuteUntil
string · datetime#scheduledActionView
objectView of a scheduled moderation action
Properties
Type of action to be executed
knownValues: takedown
When the scheduled action was created
DID of the user who created this scheduled action
Subject DID for the action
eventData
unknownSerialized event object that will be propagated to the event when performed
executeAfter
string · datetimeEarliest time to execute the action (for randomized scheduling)
executeAt
string · datetimeExact time to execute the action
executeUntil
string · datetimeLatest time to execute the action (for randomized scheduling)
executionEventId
integerID of the moderation event created when action was successfully executed
Auto-incrementing row ID
lastExecutedAt
string · datetimeWhen the action was last attempted to be executed
lastFailureReason
stringReason for the last execution failure
randomizeExecution
booleanWhether execution time should be randomized within the specified range
Current status of the scheduled action
knownValues: pending | executed | cancelled | failed
updatedAt
string · datetimeWhen the scheduled action was last updated
#subjectReviewState
stringknownValues: tools.ozone.moderation.defs#reviewOpen | tools.ozone.moderation.defs#reviewEscalated | tools.ozone.moderation.defs#reviewClosed | tools.ozone.moderation.defs#reviewNone
#subjectStatusView
objectProperties
Strike information for the account (account-level only)
ageAssuranceState
stringCurrent age assurance state of the subject.
knownValues: pending | assured | unknown | reset | blocked
ageAssuranceUpdatedBy
stringWhether or not the last successful update to age assurance was made by the user or admin.
knownValues: admin | user
appealed
booleanTrue 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.
comment
stringSticky comment on the subject.
Timestamp referencing the first moderation status impacting event was emitted on the subject
hosting
unionlastAppealedAt
string · datetimeTimestamp referencing when the author of the subject appealed a moderation action
lastReportedAt
string · datetimelastReviewedAt
string · datetimelastReviewedBy
string · didmuteReportingUntil
string · datetimemuteUntil
string · datetimepriorityScore
integerNumeric value representing the level of priority. Higher score means higher priority.
minimum: 0maximum: 100
subjectBlobCids
arraysubjectRepoHandle
stringsuspendUntil
string · datetimetags
arraytakendown
booleanTimestamp referencing when the last update was made to the moderation status of the subject
#subjectView
objectDetailed view of a subject. For record subjects, the author's repo and profile will be returned.
#timelineEventPlcCreate
tokenModeration event timeline event for a PLC create operation
#timelineEventPlcOperation
tokenModeration event timeline event for generic PLC operation
#timelineEventPlcTombstone
tokenModeration event timeline event for a PLC tombstone operation
#videoDetails
objectSimilar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Current account information, when available; this is not a snapshot of the account at the time of the action.
-
tools.ozone.moderation.emitEvent
procedureTake a moderation action on an actor.
-
social.colibri.moderation
recordA moderation event scoped to the community that owns this repo. Acts as an append-only audit log; current state is derived from the action history per subject.
-
AppView projection of a moderation_audit row. The audit log is append-only and never purged; entries survive hard-deletion of the actor account.
-
Get timeline of all available events of an account. This includes moderation events, account history and did history.