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
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| event | union 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 | - | ✅ | - |
| subjects | array of #subjectEntry | - | ✅ | Array of subjects to apply the moderation event to. |
| createdBy | string (did) | - | ✅ | - |
| modTool | tools.ozone.moderation.defs#modTool | - | ❌ | - |
Output
- Encoding: application/json
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| events | array of tools.ozone.moderation.defs#modEventView | - | ✅ | Successfully processed moderation events. |
| failedEvents | array 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.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| subject | union of com.atproto.admin.defs#repoRef com.atproto.repo.strongRef | - | ✅ | - |
| subjectBlobCids | array of string | - | ❌ | - |
| externalId | string | - | ❌ | Deduplicate events of this type for this subject using an external ID. |
| reportAction | tools.ozone.moderation.emitEvent#reportAction | - | ❌ | - |
#failedEvent
An event that failed to process.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| error | string | - | ✅ | Error message describing the reason for failure. |
| errorName | string | InvalidSubject SubjectHasAction AlreadyTakendown NotTakendown DuplicateExternalId InvalidConfiguration InvalidRequest | ❌ | Typed error identifier for programmatic handling. Omitted when the error is unexpected/uncategorized. |
| subject | union of com.atproto.admin.defs#repoRef com.atproto.repo.strongRef | - | ✅ | - |