Generated by API Evangelist
Written by API Evangelist tooling for Slack's API. It is a proposal applied on top of the contract, not a document Slack publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Slack Web Reactions API
version: 1.0.0
extends: openapi/slack-reactions-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 4
- target: $.paths['/reactions.add'].post
update:
x-apievangelist-phrasing:
intent: Add an emoji reaction to a message
effect: write
questions:
- How do I react to a message with an emoji through the API?
- What scope does my app need to add reactions?
instructions:
- text: 'React with :{name}: to the message at {timestamp} in {channel}.'
slots:
name: requestBody.name
timestamp: requestBody.timestamp
channel: requestBody.channel
- text: Add a {name} reaction to message {timestamp} in channel {channel}.
slots:
name: requestBody.name
timestamp: requestBody.timestamp
channel: requestBody.channel
method: generated
generated: '2026-09-26'
- target: $.paths['/reactions.remove'].post
update:
x-apievangelist-phrasing:
intent: Remove an emoji reaction
effect: write
questions:
- Can I take back a reaction I added by mistake?
- Is it possible to remove a reaction from a file rather than a message?
instructions:
- text: 'Remove my :{name}: reaction from message {timestamp} in {channel}.'
slots:
name: requestBody.name
timestamp: requestBody.timestamp
channel: requestBody.channel
- text: Remove the {name} reaction from file {file}.
slots:
name: requestBody.name
file: requestBody.file
- text: Take my {name} reaction off file comment {file_comment}.
slots:
name: requestBody.name
file_comment: requestBody.file_comment
method: generated
generated: '2026-09-26'
- target: $.paths['/reactions.get'].get
update:
x-apievangelist-phrasing:
intent: Get the reactions on one item
effect: read
questions:
- Which emoji reactions has a specific message received?
- Can I get the complete reaction list for a file, not just a summary?
instructions:
- text: Get the reactions on the message at {timestamp} in {channel}.
slots:
timestamp: query.timestamp
channel: query.channel
- text: Show every reaction on file {file}, full list {full}.
slots:
file: query.file
full: query.full
method: generated
generated: '2026-09-26'
- target: $.paths['/reactions.list'].get
update:
x-apievangelist-phrasing:
intent: List reactions a user has made
effect: read
questions:
- What has a given user reacted to lately?
- How do I page through all the reactions I've added?
instructions:
- text: List the reactions made by user {user}.
slots:
user: query.user
- text: Show my {limit} most recent reactions.
slots:
limit: query.limit
method: generated
generated: '2026-09-26'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.