ExStreamClient.Operations.Moderation (ExStreamClient v0.2.0)

Copy Markdown View Source

Modules for interacting with the moderation group of Stream APIs

API Reference: https://getstream.github.io/protocol/?urls.primaryName=Chat%20v2

Shared options

All functions in this module accept the following optional parameters:

  • api_key - API key to use. If not provided, the default key from config will be used
  • authenticate_as_user - User id to authenticate. If not provided, the server key will be used
  • api_key_secret - API key secret to use. If not provided, the default secret from config will be used
  • endpoint - endpoint to use. If not provided, the default endpoint from config will be used
  • client - HTTP client to use. Must implement ExStreamClient.Http.Behavior. Defaults to ExStreamClient.Http
  • req_opts - all of these options will be forwarded to req. See Req.new/1 for available options

Summary

Functions

Appeal against the moderation decision

Ban a user from a channel or the entire app

Delete multiple moderation action config entries by UUID in a single request.

Moderate multiple images in bulk using a CSV file

Create or update multiple moderation action config entries in a single request. Omit the ID field to create; provide an ID to update.

Enable or disable moderation bypass for a user. This endpoint is server-side only.

Run moderation checks on the provided content

Verifies that the configured IAM role ARN can access private S3 images for moderation. Optionally accepts a stream+s3:// URL to check access to a specific object.

Custom check, add your own AI model reports to the review queue

Delete a specific moderation action config entry by its UUID.

Delete a specific moderation policy by its name

Delete an existing moderation rule

Flag any type of content (messages, users, channels, activities) for moderation review. Supports custom content types and additional metadata for flagged content.

Returns moderation action configs grouped by entity type, sorted by order ascending. Supports fetching DB-configured actions, hardcoded defaults, or both.

Retrieve a specific appeal item by its ID

Retrieve a specific moderation configuration by its key and team. This configuration contains settings for various moderation features like toxicity detection, AI analysis, and filtering rules.

Returns the number of moderation flags created against a specific user's content. Optionally filter by entity type.

Get a specific moderation rule by ID

Retrieve a specific review queue item by its ID

Insert a moderation action log entry. Server-side only. Used by product services to log moderation-related actions.

Run moderation on text and return labels

Mute a user. Mutes are generally not visible to the user you mute, while block is something you notice.

Search and filter moderation label results with support for pagination and sorting. View the history of moderation labels applied to content.

Search and filter moderation configurations across your application. This endpoint is designed for building moderation dashboards and managing multiple configuration sets.

Query flags associated with moderation items. This is used for building a moderation dashboard.

Search and filter moderation action logs with support for pagination. View the history of moderation actions taken, including who performed them and when.

Search and filter moderation rules across your application. This endpoint is designed for building moderation dashboards and managing multiple rule sets.

Query review queue items allows you to filter the review queue items. This is used for building a moderation dashboard.

Take action on flagged content, such as marking content as safe, deleting content, banning users, or executing custom moderation actions. Supports various action types with configurable parameters.

Forward a moderator-supplied correction to the moderation feedback pipeline. Server-side only.

Unban a user from a channel or globally.

Create a new moderation action config entry or update an existing one. Action configs control the action buttons displayed in the moderation dashboard for each entity type.

Create a new moderation configuration or update an existing one. Configure settings for content filtering, AI analysis, toxicity detection, and other moderation features.

Create or update a moderation rule that can apply app-wide or to specific moderation configs

Delete a specific moderation template by its name

Retrieve a list of feed moderation templates that define preset moderation rules and configurations. Limited to 100 templates per request.

Upsert feeds template for moderation

Types

shared_opts()

@type shared_opts() :: [
  api_key: String.t(),
  api_key_secret: String.t(),
  authenticate_as_user: String.t(),
  client: module(),
  endpoint: String.t(),
  req_opts: keyword()
]

Functions

appeal(payload, opts \\ [])

Appeal against the moderation decision

Required Arguments:

Optional Arguments:

ban(payload, opts \\ [])

Ban a user from a channel or the entire app

Required Arguments:

Optional Arguments:

bulk_delete_action_config(payload, opts \\ [])

Delete multiple moderation action config entries by UUID in a single request.

Required Arguments:

Optional Arguments:

bulk_image_moderation(payload, opts \\ [])

Moderate multiple images in bulk using a CSV file

Required Arguments:

Optional Arguments:

bulk_upsert_action_config(payload, opts \\ [])

Create or update multiple moderation action config entries in a single request. Omit the ID field to create; provide an ID to update.

Required Arguments:

Optional Arguments:

bypass(payload, opts \\ [])

Enable or disable moderation bypass for a user. This endpoint is server-side only.

Required Arguments:

Optional Arguments:

check(payload, opts \\ [])

Run moderation checks on the provided content

Required Arguments:

Optional Arguments:

check_s3_access(payload, opts \\ [])

Verifies that the configured IAM role ARN can access private S3 images for moderation. Optionally accepts a stream+s3:// URL to check access to a specific object.

Required Arguments:

Optional Arguments:

custom_check(payload, opts \\ [])

Custom check, add your own AI model reports to the review queue

Required Arguments:

Optional Arguments:

delete_action_config(id, opts \\ [])

@spec delete_action_config(String.t(), [{:user_id, String.t()} | shared_opts()]) ::
  {:ok, ExStreamClient.Model.DeleteActionConfigResponse.t()} | {:error, any()}

Delete a specific moderation action config entry by its UUID.

Required Arguments:

  • id

Optional Arguments:

delete_config(key, opts \\ [])

@spec delete_config(String.t(), [
  ({:user_id, String.t()} | {:team, String.t()}) | shared_opts()
]) ::
  {:ok, ExStreamClient.Model.DeleteModerationConfigResponse.t()}
  | {:error, any()}

Delete a specific moderation policy by its name

Required Arguments:

  • key

Optional Arguments:

delete_moderation_rule(id, opts \\ [])

@spec delete_moderation_rule(String.t(), [{:user_id, String.t()} | shared_opts()]) ::
  {:ok, ExStreamClient.Model.DeleteModerationRuleResponse.t()} | {:error, any()}

Delete an existing moderation rule

Required Arguments:

  • id

Optional Arguments:

flag(payload, opts \\ [])

Flag any type of content (messages, users, channels, activities) for moderation review. Supports custom content types and additional metadata for flagged content.

Required Arguments:

Optional Arguments:

get_action_config(opts \\ [])

@spec get_action_config([
  ({:user_id, String.t()}
   | {:only_defaults, boolean()}
   | {:exclude_defaults, boolean()}
   | {:entity_type, String.t()}
   | {:queue_type, String.t()})
  | shared_opts()
]) :: {:ok, ExStreamClient.Model.GetActionConfigResponse.t()} | {:error, any()}

Returns moderation action configs grouped by entity type, sorted by order ascending. Supports fetching DB-configured actions, hardcoded defaults, or both.

Optional Arguments:

  • entity_type
  • exclude_defaults
  • only_defaults
  • queue_type
  • user_id
  • All options from Shared Options are supported.

get_appeal(id, opts \\ [])

@spec get_appeal(String.t(), shared_opts()) ::
  {:ok, ExStreamClient.Model.GetAppealResponse.t()} | {:error, any()}

Retrieve a specific appeal item by its ID

Required Arguments:

  • id

Optional Arguments:

get_config(key, opts \\ [])

@spec get_config(String.t(), [{:team, String.t()} | shared_opts()]) ::
  {:ok, ExStreamClient.Model.GetConfigResponse.t()} | {:error, any()}

Retrieve a specific moderation configuration by its key and team. This configuration contains settings for various moderation features like toxicity detection, AI analysis, and filtering rules.

Required Arguments:

  • key

Optional Arguments:

get_flag_count(payload, opts \\ [])

Returns the number of moderation flags created against a specific user's content. Optionally filter by entity type.

Required Arguments:

Optional Arguments:

get_moderation_rule(id, opts \\ [])

@spec get_moderation_rule(String.t(), shared_opts()) ::
  {:ok, ExStreamClient.Model.GetModerationRuleResponse.t()} | {:error, any()}

Get a specific moderation rule by ID

Required Arguments:

  • id

Optional Arguments:

get_review_queue_item(id, opts \\ [])

@spec get_review_queue_item(String.t(), shared_opts()) ::
  {:ok, ExStreamClient.Model.GetReviewQueueItemResponse.t()} | {:error, any()}

Retrieve a specific review queue item by its ID

Required Arguments:

  • id

Optional Arguments:

insert_action_log(payload, opts \\ [])

Insert a moderation action log entry. Server-side only. Used by product services to log moderation-related actions.

Required Arguments:

Optional Arguments:

labels(payload, opts \\ [])

Run moderation on text and return labels

Required Arguments:

Optional Arguments:

mute(payload, opts \\ [])

Mute a user. Mutes are generally not visible to the user you mute, while block is something you notice.

Required Arguments:

Optional Arguments:

query_appeals(payload, opts \\ [])

Query Appeals

Required Arguments:

Optional Arguments:

query_label_results(payload, opts \\ [])

Search and filter moderation label results with support for pagination and sorting. View the history of moderation labels applied to content.

Required Arguments:

Optional Arguments:

query_moderation_configs(payload, opts \\ [])

Search and filter moderation configurations across your application. This endpoint is designed for building moderation dashboards and managing multiple configuration sets.

Required Arguments:

Optional Arguments:

query_moderation_flags(payload, opts \\ [])

Query flags associated with moderation items. This is used for building a moderation dashboard.

Required Arguments:

Optional Arguments:

query_moderation_logs(payload, opts \\ [])

Search and filter moderation action logs with support for pagination. View the history of moderation actions taken, including who performed them and when.

Required Arguments:

Optional Arguments:

query_moderation_rules(payload, opts \\ [])

Search and filter moderation rules across your application. This endpoint is designed for building moderation dashboards and managing multiple rule sets.

Required Arguments:

Optional Arguments:

query_review_queue(payload, opts \\ [])

Query review queue items allows you to filter the review queue items. This is used for building a moderation dashboard.

Required Arguments:

Optional Arguments:

submit_action(payload, opts \\ [])

Take action on flagged content, such as marking content as safe, deleting content, banning users, or executing custom moderation actions. Supports various action types with configurable parameters.

Required Arguments:

Optional Arguments:

submit_moderation_feedback(payload, opts \\ [])

Forward a moderator-supplied correction to the moderation feedback pipeline. Server-side only.

Required Arguments:

Optional Arguments:

unban(target_user_id, payload, opts \\ [])

@spec unban(String.t(), ExStreamClient.Model.UnbanRequest.t(), [
  ({:created_by, String.t()} | {:channel_cid, String.t()}) | shared_opts()
]) :: {:ok, ExStreamClient.Model.UnbanResponse.t()} | {:error, any()}

Unban a user from a channel or globally.

Required Arguments:

Optional Arguments:

unmute(payload, opts \\ [])

Unmute a user

Required Arguments:

Optional Arguments:

upsert_action_config(payload, opts \\ [])

Create a new moderation action config entry or update an existing one. Action configs control the action buttons displayed in the moderation dashboard for each entity type.

Required Arguments:

Optional Arguments:

upsert_config(payload, opts \\ [])

Create a new moderation configuration or update an existing one. Configure settings for content filtering, AI analysis, toxicity detection, and other moderation features.

Required Arguments:

Optional Arguments:

upsert_moderation_rule(payload, opts \\ [])

Create or update a moderation rule that can apply app-wide or to specific moderation configs

Required Arguments:

Optional Arguments:

v2_delete_template(opts \\ [])

@spec v2_delete_template(shared_opts()) ::
  {:ok, ExStreamClient.Model.DeleteModerationTemplateResponse.t()}
  | {:error, any()}

Delete a specific moderation template by its name

Optional Arguments:

v2_query_templates(opts \\ [])

@spec v2_query_templates(shared_opts()) ::
  {:ok, ExStreamClient.Model.QueryFeedModerationTemplatesResponse.t()}
  | {:error, any()}

Retrieve a list of feed moderation templates that define preset moderation rules and configurations. Limited to 100 templates per request.

Optional Arguments:

v2_upsert_template(payload, opts \\ [])

Upsert feeds template for moderation

Required Arguments:

Optional Arguments: