We’ve consolidated all moderation routes into a single endpoint to simplify integrations and deliver richer, consistent responses.

The new endpoint streamlines submissions and introduces improved response data, including several new fields.

The evaluation field is the final result of the analysis of your policies and other channel specific configurations. It includes a 

 field indicating if any policies caused a flag. 

 which is calculated based on your selected policies. A higher severity score indicates more serious violations and lower severity less serious. 

The severity score can be used as a granular indication, where the flagged field is a simple binary indication. You can also use the severity score to prioritize content in your review queues. 

The response also includes a recommended action to help you decide whether to 

We recommend using this field for deciding what to do with content in your code. 

This recommendation primarily considers severityScore and author status (e.g., blocked or suspended).

You can adjust the thresholds for blocking or reviewing in your channel configurations. 

All enabled policies are returned as an array, each with:

Some policies include extra data (e.g., PII detection returns matched items).

import ModerationAPI from "@moderation-api/sdk";

const moderationApi = new ModerationAPI();

const result = await moderationApi.content.submit({
  content: { // new content structure
    type: "text",
    text: "Hello world!",
  }, 
  metaType: "message", // new field
  contentId: "message-123",
  authorId: "user-123",
  conversationId: "room-456", // renamed from contextId
  metadata: {
    customField: "value",
  },
});

// OPTION 1: Same behavior as before
if (result.evaluation.flagged) {
  // Block the content, show an error, etc...
}

// OPTION 2: Use the API's recommendation (considers severity, thresholds, and more)
switch (result.recommendation.action) {
  case "reject":
    // show error, don't save to db
    break;
  case "review":
    // save to db, but review in moderation API dashboard
    break;
  case "allow":
    // save to db
    break;
}

Moderation API changelog

Unified moderation API endpoint