Skip to main content

Event Overview

The media.moderated event is triggered when the moderation process completes for a media item. This includes both AI-based and manual moderation decisions.

Payload Structure

Payload Fields

string
required
The event type. Always media.moderated for this event.
string
required
ISO 8601 timestamp of when the event occurred.
string
required
Unique identifier for the media item in Pixel Patrol.
string
Your application’s identifier for this media item.
string
required
The site ID associated with this media.
string
required
The new moderation status: approved, rejected, or pending_review.
string
required
The status before moderation.
string
required
How the content was moderated: ai, manual, or rule.
string
required
Timestamp when moderation completed.
object
Detailed information about the moderation decision.
array
List of rules that were violated (if any).
object
AI confidence scores for different content categories.
object
Custom metadata provided during submission.

Status Values

  • approved: Content passed moderation and is safe to display
  • rejected: Content violated one or more rules and should not be displayed
  • pending_review: Content requires manual review by a moderator

Example Implementation

Use Cases

  • Content Publishing: Automatically publish approved content
  • User Notifications: Inform users about moderation decisions
  • Content Removal: Remove or hide rejected content
  • Manual Review Queue: Route edge cases to human moderators
  • Analytics: Track approval/rejection rates and reasons