Skip to main content
Moderation API logo
  • Category: ai safety compliance detection
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: MODERATIONAPI
  • Version: 20261101_00

Tools

Slug: MODERATIONAPI_EVALUATE_CONTENTEvaluate content without retaining it or adding it to a review queue, and return policy findings and the recommended moderation action.

Input Parameters

string
Channel ID or key; omit to use the project’s default channel.
string
required
Text, image, video, audio, or structured object content to moderate.
object
Caller metadata to include with the moderation request.
string
External author ID to associate with the content.
string ("profile" | "message" | "post" | "comment" | "event" | "product" | "review" | "voice" | "other")
Business type of the submitted content.
number
Unix timestamp in milliseconds when non-real-time content was created.
string
Stable content ID from the caller’s system.
object
Optional caller recommendation combined with the provider recommendation.
string
Conversation, room, thread, or parent-post ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_EXECUTE_ACTIONApply a discovered moderation action to content items or authors. Actions can reject content or block or suspend authors and may be irreversible; inspect LIST_ACTIONS before calling.

Input Parameters

string
Action value when LIST_ACTIONS reports that a value is required.
string
Queue ID when executing a queue-specific action.
string
required
Action ID or key returned by LIST_ACTIONS.
array
Author IDs to act on; provide author_ids, content_ids, or both.
array
Content IDs to act on; provide content_ids, author_ids, or both.
number
Duration in milliseconds for a temporary action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_GET_ACCOUNTReturn the connected Moderation API account, plan, current project, and current quota values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_GET_REVIEW_QUEUEReturn metadata and item counts for a review queue by ID. Requires the paid review-queue add-on; contact Moderation API sales if review queues are not enabled for the connected organization.

Input Parameters

string
required
Review queue ID obtained from the Moderation API dashboard or configuration.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_GET_WORDLISTReturn one wordlist and its current words by ID.

Input Parameters

string
required
Wordlist ID returned by LIST_WORDLISTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_LIST_ACTIONSList the project’s moderation actions, optionally restricted to a review queue. The provider list is paginated; this tool requests one page.

Input Parameters

string
Return actions available for this review queue ID; omit to return all organization actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_LIST_REVIEW_QUEUE_ITEMSList and filter one page of moderation items in a review queue. Requires the paid Moderation API review-queue add-on.

Input Parameters

string
Continuation cursor from a previous response’s next_cursor. Omit for the first page and pass it back unchanged to fetch the next page.
string
required
Review queue ID.
string
Only return items associated with this author ID.
integer
Maximum number of queue items to return in this page.
string ("createdAt" | "severity" | "reviewedAt")
Field used to order queue items.
string ("asc" | "desc")
Direction used to order queue items.
boolean
Whether to include resolved queue items in the results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_LIST_WORDLISTSList a page of the organization’s wordlists and their identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_MODIFY_WORDLIST_WORDSAdd words to or remove words from an existing wordlist.

Input Parameters

array
required
Non-empty words to add or remove; duplicate additions are ignored.
string ("add" | "remove")
required
Whether to add the supplied words or remove them.
string
required
Wordlist ID returned by LIST_WORDLISTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_SET_REVIEW_QUEUE_ITEM_STATUSMark a review queue item resolved or return it to pending. Requires the paid review-queue add-on.

Input Parameters

string ("resolved" | "pending")
required
Desired queue item status: resolved or pending.
string
Optional reason for the status change.
string
required
Queue item ID returned by LIST_REVIEW_QUEUE_ITEMS.
string
required
Review queue ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MODERATIONAPI_SUBMIT_CONTENT_FOR_MODERATIONEvaluate content and allow Moderation API to retain it and add it to a review queue according to the project’s configuration.

Input Parameters

string
Channel ID or key; omit to use the project’s default channel.
string
required
Text, image, video, audio, or structured object content to moderate.
object
Caller metadata to include with the moderation request.
string
External author ID to associate with the content.
string ("profile" | "message" | "post" | "comment" | "event" | "product" | "review" | "voice" | "other")
Business type of the submitted content.
number
Unix timestamp in milliseconds when non-real-time content was created.
string
Stable content ID from the caller’s system.
object
Optional caller recommendation combined with the provider recommendation.
string
Conversation, room, thread, or parent-post ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not