Update global application settings
Updates the global application settings that are applied to all channels within the application.
Note: The default length of time that messages are retained for in Sendbird Chat is six months, or 4,380 hours. If you wish to change this maximum message retention period, contact our sales team.
HTTP request
Request body
The following table lists the properties of an HTTP request that this action supports.
Optional
Property name | Type | Description |
---|---|---|
display_past_message | boolean | Determines whether to display past messages to new members of a group channel. If set to |
allow_links | boolean | Determines whether to allow clickable links in a message within the application. (Default: |
max_message_length | integer | Specifies the maximum character length of a message allowed to be sent within the application. Acceptable values are |
user_messages_per_channel | integer | Specifies the maximum number of messages which a user is allowed to send in a channel during the time duration set in |
user_messages_per_channel_duration | integer | Specifies the time duration in seconds in which a user can send the set number of messages in a channel. This property works in conjunction with |
nested object | A domain filter configuration to filter out text and file messages with URLs that contain the domain set. | |
domain_filter.domains[] | array of strings | Specifies an array of domains to detect. Each item of the array should be specified in a combination of domain name and TLD (top level domain) like amazon.com. |
domain_filter.type | integer | Determines which filter to apply to messages with URLs that contain any of the domain set. Acceptable values are the following: |
nested object | A filter configuration on certain words and patterns for matching character combinations in strings, which are not allowed to be used within the application. | |
profanity_filter.keywords[] | array of strings | Specifies an array of words to detect. |
profanity_filter.regex_filters[] | array of strings | Specifies an array of regular expressions used for detecting. Each item of the list should be specified in |
profanity_filter.type | integer | Determines which filtering method to apply to messages that contain the specified keywords or regular expressions. Acceptable values are the following: |
nested object | A moderation configuration on which penalty is automatically imposed on users who reach the profanity violation limit within a channel. | |
profanity_triggered_moderation.count | integer | Specifies the number of profanity violation limit before a penalty is imposed on a user. |
profanity_triggered_moderation.duration | integer | Specifies the duration of the time window in seconds which counts the number of a user’s violations within a channel. For example, if the |
profanity_triggered_moderation.action | integer | Determines the type of moderation penalty within a channel which is permanently imposed on users until canceled. Acceptable values are the following: |
nested object | A moderation configuration on inappropriate images in the application. Google Cloud Vision API is used for image moderation and supports many types of images. | |
image_moderation.type | integer | Determines the moderation method to apply to the images and image URLs in the text and file messages. Acceptable values are the following: |
image_moderation.soft_block | boolean | If |
image_moderation.limits | nested object | A set of values returned after an image has been moderated. These limit numbers range from one to five and specify the likelihood of the image passing the moderation standard. Acceptable likelihood values are the following: |
image_moderation.limits.adult | integer | Specifies the likelihood of the image containing an adult content. |
image_moderation.limits.spoof | integer | Specifies spoof likelihood which is the likelihood that a modification was made to the image to make it appear funny or offensive. |
image_moderation.limits.medical | integer | Specifies the likelihood of the image being a medical image. |
image_moderation.limits.violence | integer | Specifies the likelihood of the image containing violent content. |
image_moderation.limits.racy | integer | Specifies the likelihood of the image containing racy content. |
image_moderation.check_urls | boolean | Determines whether to check if the image URLs in the text and file messages are appropriate. |
Response
If successful, this action returns the created global application settings resource in the response body.
In the case of an error, an error object is returned. A detailed list of error codes is available here.