> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Moderation API

> Moderation API provides content detection, human review workflows, author management, and moderation actions for online platforms.

![Moderation API logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/moderationapi.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=23dd8765c21698135b16a9e452d0a69a)

* **Category:** ai safety compliance detection
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `MODERATIONAPI`
* **Version:** 20261101\_00

## Tools

> [accordion] Evaluate Content Without Storage
>
> **Slug:** `MODERATIONAPI_EVALUATE_CONTENT`
>
> Evaluate content without retaining it or adding it to a review queue, and return policy findings and the recommended moderation action.
>
> #### Input Parameters
>
> **channel** `string`
>
> Channel ID or key; omit to use the project's default channel.
>
> **content** `string` *required*
>
> Text, image, video, audio, or structured object content to moderate.
>
> **metadata** `object`
>
> Caller metadata to include with the moderation request.
>
> **author\_id** `string`
>
> External author ID to associate with the content.
>
> **meta\_type** `string ("profile" | "message" | "post" | "comment" | "event" | "product" | "review" | "voice" | "other")`
>
> Business type of the submitted content.
>
> **timestamp** `number`
>
> Unix timestamp in milliseconds when non-real-time content was created.
>
> **content\_id** `string`
>
> Stable content ID from the caller's system.
>
> **client\_action** `object`
>
> Optional caller recommendation combined with the provider recommendation.
>
> **conversation\_id** `string`
>
> Conversation, room, thread, or parent-post ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute Moderation Action
>
> **Slug:** `MODERATIONAPI_EXECUTE_ACTION`
>
> Apply 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
>
> **value** `string`
>
> Action value when LIST\_ACTIONS reports that a value is required.
>
> **queue\_id** `string`
>
> Queue ID when executing a queue-specific action.
>
> **action\_key** `string` *required*
>
> Action ID or key returned by LIST\_ACTIONS.
>
> **author\_ids** `array`
>
> Author IDs to act on; provide author\_ids, content\_ids, or both.
>
> **content\_ids** `array`
>
> Content IDs to act on; provide content\_ids, author\_ids, or both.
>
> **duration\_ms** `number`
>
> Duration in milliseconds for a temporary action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account and Quota
>
> **Slug:** `MODERATIONAPI_GET_ACCOUNT`
>
> Return the connected Moderation API account, plan, current project, and current quota values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Review Queue
>
> **Slug:** `MODERATIONAPI_GET_REVIEW_QUEUE`
>
> Return 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
>
> **queue\_id** `string` *required*
>
> Review queue ID obtained from the Moderation API dashboard or configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Wordlist
>
> **Slug:** `MODERATIONAPI_GET_WORDLIST`
>
> Return one wordlist and its current words by ID.
>
> #### Input Parameters
>
> **wordlist\_id** `string` *required*
>
> Wordlist ID returned by LIST\_WORDLISTS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Moderation Actions
>
> **Slug:** `MODERATIONAPI_LIST_ACTIONS`
>
> List the project's moderation actions, optionally restricted to a review queue. The provider list is paginated; this tool requests one page.
>
> #### Input Parameters
>
> **queue\_id** `string`
>
> Return actions available for this review queue ID; omit to return all organization actions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Review Queue Items
>
> **Slug:** `MODERATIONAPI_LIST_REVIEW_QUEUE_ITEMS`
>
> List and filter one page of moderation items in a review queue. Requires the paid Moderation API review-queue add-on.
>
> #### Input Parameters
>
> **cursor** `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.
>
> **queue\_id** `string` *required*
>
> Review queue ID.
>
> **author\_id** `string`
>
> Only return items associated with this author ID.
>
> **page\_size** `integer`
>
> Maximum number of queue items to return in this page.
>
> **sort\_field** `string ("createdAt" | "severity" | "reviewedAt")`
>
> Field used to order queue items.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Direction used to order queue items.
>
> **include\_resolved** `boolean`
>
> Whether to include resolved queue items in the results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Wordlists
>
> **Slug:** `MODERATIONAPI_LIST_WORDLISTS`
>
> List a page of the organization's wordlists and their identifiers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Modify Wordlist Words
>
> **Slug:** `MODERATIONAPI_MODIFY_WORDLIST_WORDS`
>
> Add words to or remove words from an existing wordlist.
>
> #### Input Parameters
>
> **words** `array` *required*
>
> Non-empty words to add or remove; duplicate additions are ignored.
>
> **operation** `string ("add" | "remove")` *required*
>
> Whether to add the supplied words or remove them.
>
> **wordlist\_id** `string` *required*
>
> Wordlist ID returned by LIST\_WORDLISTS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Review Queue Item Status
>
> **Slug:** `MODERATIONAPI_SET_REVIEW_QUEUE_ITEM_STATUS`
>
> Mark a review queue item resolved or return it to pending. Requires the paid review-queue add-on.
>
> #### Input Parameters
>
> **status** `string ("resolved" | "pending")` *required*
>
> Desired queue item status: resolved or pending.
>
> **comment** `string`
>
> Optional reason for the status change.
>
> **item\_id** `string` *required*
>
> Queue item ID returned by LIST\_REVIEW\_QUEUE\_ITEMS.
>
> **queue\_id** `string` *required*
>
> Review queue ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Content for Moderation
>
> **Slug:** `MODERATIONAPI_SUBMIT_CONTENT_FOR_MODERATION`
>
> Evaluate content and allow Moderation API to retain it and add it to a review queue according to the project's configuration.
>
> #### Input Parameters
>
> **channel** `string`
>
> Channel ID or key; omit to use the project's default channel.
>
> **content** `string` *required*
>
> Text, image, video, audio, or structured object content to moderate.
>
> **metadata** `object`
>
> Caller metadata to include with the moderation request.
>
> **author\_id** `string`
>
> External author ID to associate with the content.
>
> **meta\_type** `string ("profile" | "message" | "post" | "comment" | "event" | "product" | "review" | "voice" | "other")`
>
> Business type of the submitted content.
>
> **timestamp** `number`
>
> Unix timestamp in milliseconds when non-real-time content was created.
>
> **content\_id** `string`
>
> Stable content ID from the caller's system.
>
> **client\_action** `object`
>
> Optional caller recommendation combined with the provider recommendation.
>
> **conversation\_id** `string`
>
> Conversation, room, thread, or parent-post ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
