Chat / Platform API
Current version: v3
    Chat Platform API v3
    Chat Platform API
    Chat
    Platform API
    Home
    /
    Chat
    /
    Platform API
    /
    Message

    Remove a reaction

    Removes a specific reaction from a message.

    Note: Currently, this action is only available in group channels.


    HTTP request

    DELETE https://api-{application_id}.sendbird.com/v3/{channel_type}/{channel_url}/messages/{message_id}/reactions
    

    Parameters

    The following table lists the parameters that this action supports.

    Required
    Parameter nameTypeDescription

    channel_type

    string

    Specifies the type of the channel. Currently, the only acceptable value is group_channels.

    channel_url

    string

    Specifies the URL of the target channel.

    message_id

    long

    Specifies the unique ID of the message to remove a reaction from.

    user_id

    string

    Specifies the ID of the user who reacted to the message. Urlencoding the value is recommended (for example, ?user_id=urlencoded_id).

    reaction

    string

    Specifies the key of the reaction to be removed from the message. The length is limited to 192 characters.

    ?user_id=Jessie&reaction=celebrate
    

    Response

    If successful, this action returns the information about the reaction event in the response body.

    {
        "user_id": "Jessie",
        "operation": "DELETE",
        "success": true,
        "reaction": "celebrate",
        "updated_at": 1577327594231
    }
    

    List of response properties

    Property nameTypeDescription

    user_id

    string

    The ID of the user who reacted to the message.

    operation

    string

    The operation type of the request. Valid values are ADD and DELETE.

    success

    boolean

    Indicates whether the reaction operation succeeded or failed. The value of false indicates that there is an identical operation attempt made by the same user to the same message.

    reaction

    string

    The unique key of the reaction.

    updated_at

    long

    The time when the message reaction was updated in Unix milliseconds. This appears only when the success property is true.

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