/ Platform API
Platform API
    Chat Platform API v3
    Chat Platform API
    Chat Platform API
    Version 3

    Report a channel

    Copy link

    Reports a channel that has offensive messages or abusive activities.


    HTTP request

    Copy link
    POST https://api-{application_id}.sendbird.com/v3/report/{channel_type}/{channel_url}
    

    Parameters

    Copy link

    The following table lists the parameters that this action supports.

    Required
    Parameter nameTypeDescription

    channel_type

    string

    Specifies the type of channel. Acceptable values are open_channels and group_channels.

    channel_url

    string

    Specifies the URL of a channel.


    Request body

    Copy link

    The following table lists the properties of an HTTP request that this action supports.

    Properties
    RequiredTypeDescription

    report_category

    string

    Specifies the category which indicates the reason for reporting. Acceptable values are suspicious, harassing, inappropriate, spam, and custom. If this property is set to custom, the custom_report_category_name must be specified.

    OptionalTypeDescription

    reporting_user_id

    string

    Specifies the unique ID of the user who reports a channel.

    report_description

    string

    Specifies additional information to include in the report.

    custom_report_category_name

    string

    Specifies the name of the custom report category. Maximum length is 50 characters.

    {
        "report_category": "inappropriate",
        "report_description": "Seems that people here are sharing something wrong."
    }
    

    Response

    Copy link

    If successful, this action returns a report resource on the channel in the response body.

    In the case of an error, an error object is returned. A detailed list of error codes is available here.