reaction_remove
reaction_remove is implemented by handleReactionRemove in src/api/handlers/reaction/reaction_remove.osl.
Handles the reaction remove protocol operation through the resource-specific helper and storage layers.
Access
Section titled “Access”| Gate | Requirement |
|---|---|
| Authentication | Required by the central API gate. |
| Central permission | None. Resource, channel, ownership, or hierarchy checks may still apply in the handler/helpers. |
| Broadcast | Yes. The transport removes the internal marker and filters recipients by channel visibility. |
Request
Section titled “Request”Every request includes cmd: "reaction_remove" and may include an opaque listener correlation value.
| Field | Validation / meaning |
|---|---|
channel |
schema.string().defaultValue("") |
thread_id |
schema.string().defaultValue("") |
id |
schema.string().minLen(1) |
emoji |
schema.string().minLen(1).maxLen(200) |
cmd |
Read separately by the handler or a shared domain helper |
Validator source
Section titled “Validator source”The handler and shared validation path use these OSL schema definitions before normalization:
*schema.Schema schemaReactionChange = schema.object({ channel: schema.string().defaultValue(""), thread_id: schema.string().defaultValue(""), id: schema.string().minLen(1), emoji: schema.string().minLen(1).maxLen(200)})Shared validation and domain flow: src/api/helpers/reactions.osl.
Processing path
Section titled “Processing path”handleCmdenforces authentication.dispatchCmdroutesreaction_removetohandleReactionRemove.- The adapter validates and normalizes input, then calls its domain collaborators.
- Durable mutations complete before the response or event is returned.
onMessageadds the request listener to direct responses and performs any marked broadcast.
Direct collaborators visible in the handler: reactionChange, messageContext, messageTimeoutLimit, canUserReactInChannel, storedMessageById, else, configGetString, storedMessageRewrite
Responses and events
Section titled “Responses and events”Response/event command names visible in this adapter: reaction_remove.
Validation and domain failures use:
{ "cmd": "error", "val": "<message>", "src": "reaction_remove", "listener": "<copied from request>"}