tools.ozone.moderation.defs

kind defs authority moderation.ozone.tools lexicon 1 did:plc:33dt5kftu3jq2h5h4jjlqezt · indexed 106d ago

Showing version bafyreifhnzfv3etivjj7xtat4akmexvrprpigqrr5lk5bhjrhsvlrptlbi. Show the latest

#accountEvent

object

Logs account status related events on a repo subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.

Properties

active

requiredboolean

Indicates that the account has a repository which can be fetched from the host that emitted this event.

comment

string

status

string
  • knownValues: unknown | deactivated | deleted | takendown | suspended | tombstoned

timestamp

requiredstring · datetime

#accountHosting

object

Properties

createdAt

string · datetime

deactivatedAt

string · datetime

deletedAt

string · datetime

reactivatedAt

string · datetime

status

requiredstring
  • knownValues: takendown | suspended | deleted | deactivated | unknown

updatedAt

string · datetime

#accountStats

object

Statistics about a particular account subject

Properties

Total number of appeals against a moderation action on the account

Number of times the account was escalated

Total number of reports on the account

Number of times the account was suspended

Number of times the account was taken down

#accountStrike

object

Strike information for an account

Properties

Current number of active strikes (excluding expired strikes)

firstStrikeAt

string · datetime

Timestamp of the first strike received

lastStrikeAt

string · datetime

Timestamp of the most recent strike received

Total number of strikes ever received (including expired strikes)

#ageAssuranceEvent

object

Age assurance info coming directly from users. Only works on DID subjects.

Properties

attemptId

requiredstring

The unique identifier for this instance of the age assurance flow, in UUID format.

The IP address used when completing the AA flow.

The user agent used when completing the AA flow.

The ISO 3166-1 alpha-2 country code provided when beginning the Age Assurance flow.

createdAt

requiredstring · datetime

The date and time of this write operation.

initIp

string

The IP address used when initiating the AA flow.

initUa

string

The user agent used when initiating the AA flow.

The ISO 3166-2 region code provided when beginning the Age Assurance flow.

status

requiredstring

The status of the Age Assurance process.

  • knownValues: unknown | pending | assured

#ageAssuranceOverrideEvent

object

Age assurance status override by moderators. Only works on DID subjects.

Properties

comment

requiredstring

Comment describing the reason for the override.

  • minLength: 1

status

requiredstring

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

object

Purges all age assurance events for the subject. Only works on DID subjects. Moderator-only.

Properties

comment

requiredstring

Comment describing the reason for the purge.

  • minLength: 1

#blobView

object

Properties

cid

requiredstring · cid

createdAt

requiredstring · datetime

mimeType

requiredstring
Reference

size

requiredinteger

#cancelScheduledTakedownEvent

object

Logs cancellation of a scheduled takedown action for an account.

Properties

comment

string

#identityEvent

object

Logs identity related events on a repo subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.

Properties

comment

string

handle

string · handle

pdsHost

string · uri

timestamp

requiredstring · datetime

tombstone

boolean

#imageDetails

object

Properties

height

requiredinteger

width

requiredinteger

#modEventAcknowledge

object

Properties

If true, all other reports on content authored by this account will be resolved (acknowledged).

comment

string

#modEventComment

object

Add a comment to a subject. An empty comment will clear any previously set sticky comment.

Properties

comment

string

sticky

boolean

Make the comment persistent on the subject

#modEventDivert

object

Divert a record's blobs to a 3rd party service for further scanning/tagging

Properties

comment

string

#modEventEmail

object

Keep a log of outgoing email to a user

Properties

comment

string

Additional comment about the outgoing comm.

content

string

The content of the email sent to the user.

Indicates whether the email was successfully delivered to the user's inbox.

Names/Keywords of the policies that necessitated the email.

  • maxLength: 5
itemsstring

Severity level of the violation. Normally 'sev-1' that adds strike on repeat offense

Number 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 · datetime

When the strike should expire. If not provided, the strike never expires.

subjectLine

requiredstring

The subject line of the email sent to the user.

#modEventEscalate

object

Properties

comment

string

#modEventLabel

object

Apply/Negate labels on a subject

Properties

comment

string

createLabelVals

requiredarray
itemsstring

Indicates how long the label will remain on the subject. Only applies on labels that are being added.

negateLabelVals

requiredarray
itemsstring

#modEventMute

object

Mute incoming reports on a subject

Properties

comment

string

durationInHours

requiredinteger

Indicates how long the subject should remain muted.

#modEventMuteReporter

object

Mute incoming reports from an account

Properties

comment

string

Indicates how long the account should remain muted. Falsy value here means a permanent mute.

#modEventPriorityScore

object

Set priority score of the subject. Higher score means higher priority.

Properties

comment

string

score

requiredinteger
  • minimum: 0
  • maximum: 100

#modEventReport

object

Report a subject

Properties

comment

string

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.

#modEventResolveAppeal

object

Resolve appeal on a subject

Properties

comment

string

Describe resolution.

#modEventReverseTakedown

object

Revert take down action on a subject

Properties

comment

string

Describe reasoning behind the reversal.

Names/Keywords of the policy infraction for which takedown is being reversed.

  • maxLength: 5
itemsstring

Severity level of the violation. Usually set from the last policy infraction's severity.

Number of strikes to subtract from the user's strike count. Usually set from the last policy infraction's severity.

#modEventTag

object

Add/Remove a tag on a subject

Properties

add

requiredarray

Tags to be added to the subject. If already exists, won't be duplicated.

itemsstring

comment

string

Additional comment about added/removed tags.

remove

requiredarray

Tags to be removed to the subject. Ignores a tag If it doesn't exist, won't be duplicated.

itemsstring

#modEventTakedown

object

Take down a subject permanently or temporarily

Properties

If true, all other reports on content authored by this account will be resolved (acknowledged).

comment

string

Indicates how long the takedown should be in effect before automatically expiring.

Names/Keywords of the policies that drove the decision.

  • maxLength: 5
itemsstring

Severity level of the violation (e.g., 'sev-0', 'sev-1', 'sev-2', etc.).

Number of strikes to assign to the user for this violation.

strikeExpiresAt

string · datetime

When the strike should expire. If not provided, the strike never expires.

List of services where the takedown should be applied. If empty or not provided, takedown is applied on all configured services.

itemsstring
  • knownValues: appview | pds

#modEventUnmute

object

Unmute action on a subject

Properties

comment

string

Describe reasoning behind the reversal.

#modEventUnmuteReporter

object

Unmute incoming reports from an account

Properties

comment

string

Describe reasoning behind the reversal.

#modEventView

object

#modEventViewDetail

object

#modTool

object

Moderation tool information for tracing the source of the action

Properties

meta

unknown

Additional arbitrary metadata about the source

name

requiredstring

Name/identifier of the source (e.g., 'automod', 'ozone/workspace')

#moderation

object

Properties

#moderationDetail

object

Properties

#recordEvent

object

Logs lifecycle event on a record subject. Normally captured by automod from the firehose and emitted to ozone for historical tracking.

Properties

cid

string · cid

comment

string

op

requiredstring
  • knownValues: create | update | delete

timestamp

requiredstring · datetime

#recordHosting

object

Properties

createdAt

string · datetime

deletedAt

string · datetime

status

requiredstring
  • knownValues: deleted | unknown

updatedAt

string · datetime

#recordView

object

Properties

blobCids

requiredarray
itemsstring · cid

cid

requiredstring · cid

indexedAt

requiredstring · datetime

moderation

requiredref
Reference

repo

requiredref
Reference

uri

requiredstring · at-uri

value

requiredunknown

#recordViewDetail

object

Properties

blobs

requiredarray
itemsref
Reference

cid

requiredstring · cid

indexedAt

requiredstring · datetime

labels

array
itemsref

moderation

requiredref
Reference

repo

requiredref
Reference

uri

requiredstring · at-uri

value

requiredunknown

#recordViewNotFound

object

Properties

uri

requiredstring · at-uri

#recordsStats

object

Statistics about a set of record subject items

Properties

Number of items that were appealed at least once

Number of items that were escalated at least once

Number of item currently in "reviewOpen" or "reviewEscalated" state

Number of item currently in "reviewNone" or "reviewClosed" state

Number of items that were reported at least once

Total number of item in the set

Number of item currently taken down

Cumulative sum of the number of reports on the items in the set

#repoView

object

Properties

deactivatedAt

string · datetime

did

requiredstring · did

email

string

handle

requiredstring · handle

indexedAt

requiredstring · datetime

moderation

requiredref
Reference

relatedRecords

requiredarray
itemsunknown

#repoViewDetail

object

Properties

deactivatedAt

string · datetime

did

requiredstring · did

email

string

emailConfirmedAt

string · datetime

handle

requiredstring · handle

indexedAt

requiredstring · datetime

labels

array
itemsref

moderation

requiredref
Reference

relatedRecords

requiredarray
itemsunknown

#repoViewNotFound

object

Properties

did

requiredstring · did

#reporterStats

object

Properties

accountReportCount

requiredinteger

The total number of reports made by the user on accounts.

did

requiredstring · did

labeledAccountCount

requiredinteger

The total number of accounts labeled as a result of the user's reports.

labeledRecordCount

requiredinteger

The total number of records labeled as a result of the user's reports.

recordReportCount

requiredinteger

The total number of reports made by the user on records.

reportedAccountCount

requiredinteger

The total number of accounts reported by the user.

reportedRecordCount

requiredinteger

The total number of records reported by the user.

takendownAccountCount

requiredinteger

The total number of accounts taken down as a result of the user's reports.

takendownRecordCount

requiredinteger

The total number of records taken down as a result of the user's reports.

#reviewClosed

token

Moderator review status of a subject: Closed. Indicates that the subject was already reviewed and resolved by a moderator

#reviewEscalated

token

Moderator review status of a subject: Escalated. Indicates that the subject was escalated for review by a moderator

#reviewNone

token

Moderator 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

token

Moderator review status of a subject: Open. Indicates that the subject needs to be reviewed by a moderator

#revokeAccountCredentialsEvent

object

Account credentials revocation by moderators. Only works on DID subjects.

Properties

comment

requiredstring

Comment describing the reason for the revocation.

  • minLength: 1

#scheduleTakedownEvent

object

Logs a scheduled takedown action for an account.

Properties

comment

string

executeAfter

string · datetime

executeAt

string · datetime

executeUntil

string · datetime

#scheduledActionView

object

View of a scheduled moderation action

Properties

action

requiredstring

Type of action to be executed

  • knownValues: takedown

createdAt

requiredstring · datetime

When the scheduled action was created

createdBy

requiredstring · did

DID of the user who created this scheduled action

did

requiredstring · did

Subject DID for the action

eventData

unknown

Serialized event object that will be propagated to the event when performed

executeAfter

string · datetime

Earliest time to execute the action (for randomized scheduling)

executeAt

string · datetime

Exact time to execute the action

executeUntil

string · datetime

Latest time to execute the action (for randomized scheduling)

ID of the moderation event created when action was successfully executed

id

requiredinteger

Auto-incrementing row ID

lastExecutedAt

string · datetime

When the action was last attempted to be executed

Reason for the last execution failure

Whether execution time should be randomized within the specified range

status

requiredstring

Current status of the scheduled action

  • knownValues: pending | executed | cancelled | failed

updatedAt

string · datetime

When the scheduled action was last updated

#subjectReviewState

string
  • knownValues: tools.ozone.moderation.defs#reviewOpen | tools.ozone.moderation.defs#reviewEscalated | tools.ozone.moderation.defs#reviewClosed | tools.ozone.moderation.defs#reviewNone

#subjectStatusView

object

Properties

Statistics related to the account subject

Reference

Strike information for the account (account-level only)

Reference

Current age assurance state of the subject.

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

Whether or not the last successful update to age assurance was made by the user or admin.

  • knownValues: admin | user

appealed

boolean

True 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

string

Sticky comment on the subject.

createdAt

requiredstring · datetime

Timestamp referencing the first moderation status impacting event was emitted on the subject

id

requiredinteger

lastAppealedAt

string · datetime

Timestamp referencing when the author of the subject appealed a moderation action

lastReportedAt

string · datetime

lastReviewedAt

string · datetime

lastReviewedBy

string · did

muteReportingUntil

string · datetime

muteUntil

string · datetime

Numeric value representing the level of priority. Higher score means higher priority.

  • minimum: 0
  • maximum: 100

Statistics related to the record subjects authored by the subject's account

Reference

reviewState

requiredref
itemsstring · cid

suspendUntil

string · datetime

tags

array
itemsstring

takendown

boolean

updatedAt

requiredstring · datetime

Timestamp referencing when the last update was made to the moderation status of the subject

#subjectView

object

Detailed view of a subject. For record subjects, the author's repo and profile will be returned.

Properties

profile

union
One of
Reference

repo

ref
Reference
Reference

subject

requiredstring

#timelineEventPlcCreate

token

Moderation event timeline event for a PLC create operation

#timelineEventPlcOperation

token

Moderation event timeline event for generic PLC operation

#timelineEventPlcTombstone

token

Moderation event timeline event for a PLC tombstone operation

#videoDetails

object

Properties

height

requiredinteger

length

requiredinteger

width

requiredinteger

Similar lexicons

semantic match

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

  • A single moderation action taken against a subject.

  • Activity recording a moderator being assigned to a report.

  • A 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.