# chat_remove_reaction

Remove Chat Reaction

## Beschreibung

Removes the caller's own emoji reaction from a chat message.
No `user_id` param — moderation of others' reactions stays in
the web UI. Error if the caller hasn't reacted with that emoji.
Response echoes the remaining reactions on the message.

## Zugriff

Zugriffsprofil: `basic`. Module: `chat`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja | Account prefix ID (e.g., acct_abc123). |
| `channel_id` | string | Ja | Channel prefix ID (e.g., chan_xyz789). |
| `message_id` | string | Ja | Message prefix ID (e.g., msg_abc123) of the target. |
| `emoji` | string | Ja | The exact emoji string you added (Unicode — same value you passed to chat_add_reaction). |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID (e.g., acct_abc123)."
    },
    "channel_id": {
      "type": "string",
      "description": "Channel prefix ID (e.g., chan_xyz789)."
    },
    "message_id": {
      "type": "string",
      "description": "Message prefix ID (e.g., msg_abc123) of the target."
    },
    "emoji": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32,
      "description": "The exact emoji string you added (Unicode — same value you passed to chat_add_reaction)."
    }
  },
  "required": [
    "account_id",
    "channel_id",
    "message_id",
    "emoji"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "message_id": {
      "type": "string"
    },
    "emoji": {
      "type": "string"
    },
    "removed": {
      "type": "boolean"
    },
    "reactions": {
      "type": "array",
      "description": "Reactions remaining on the message after removal, ordered by created_at ASC.",
      "items": {
        "type": "object",
        "properties": {
          "emoji": {
            "type": "string"
          },
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "handle": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "emoji",
          "user",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "message_id",
    "emoji",
    "removed",
    "reactions"
  ],
  "type": "object"
}
```