# 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'