Skip to main content

tools.ozone.moderation.emitEvents

#main​

Take a moderation action on multiple subjects at once. Each subject is processed independently; failures are listed in failedEvents. Only the listed event types are supported.

Input​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
eventunion of
tools.ozone.moderation.defs#modEventTakedown
tools.ozone.moderation.defs#modEventAcknowledge
tools.ozone.moderation.defs#modEventLabel
tools.ozone.moderation.defs#modEventReport
tools.ozone.moderation.defs#modEventReverseTakedown
tools.ozone.moderation.defs#modEventResolveAppeal
tools.ozone.moderation.defs#modEventEmail
tools.ozone.moderation.defs#modEventTag
tools.ozone.moderation.defs#revokeAccountCredentialsEvent
-✅-
subjectsarray of #subjectEntry-✅Array of subjects to apply the moderation event to.
createdBystring (did)-✅-
modTooltools.ozone.moderation.defs#modTool-❌-

Output​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
eventsarray of tools.ozone.moderation.defs#modEventView-✅Successfully processed moderation events.
failedEventsarray of #failedEvent-✅Events that failed to process.

#subjectEntry​

A subject with optional blob CIDs, external event ID, and report-level targeting. Report targeting applies only to this entry.

PropertyTypeKnown ValuesRequiredDescription
subjectunion of
com.atproto.admin.defs#repoRef
com.atproto.repo.strongRef
-✅-
subjectBlobCidsarray of string-❌-
externalIdstring-❌Deduplicate events of this type for this subject using an external ID.
reportActiontools.ozone.moderation.emitEvent#reportAction-❌-

#failedEvent​

An event that failed to process.

PropertyTypeKnown ValuesRequiredDescription
errorstring-✅Error message describing the reason for failure.
errorNamestringInvalidSubject
SubjectHasAction
AlreadyTakendown
NotTakendown
DuplicateExternalId
InvalidConfiguration
InvalidRequest
❌Typed error identifier for programmatic handling. Omitted when the error is unexpected/uncategorized.
subjectunion of
com.atproto.admin.defs#repoRef
com.atproto.repo.strongRef
-✅-