Zum Inhalt
Für Agenten

chat_remove_reaction

Remove Chat Reaction

Markdown Tools als JSON

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

{
  "$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

{
  "$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"
}
Seiten