Slack · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Slack Web Users API

5 actions 5 updates phrasing extends openapi/slack-users-api-openapi.yml

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.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/users.list'].get

$.paths['/users.info'].get

$.paths['/users.lookupByEmail'].get

$.paths['/users.getPresence'].get

OpenAPI Overlay

# 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 Users API
  version: 1.0.0
extends: openapi/slack-users-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['/users.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List all users in the workspace
      effect: read
      questions:
      - How do I pull a full member directory from Slack?
      - Can I list users for a specific team in an Enterprise Grid org?
      instructions:
      - text: List every member of the workspace.
      - text: List users in team {team_id}, {limit} per page.
        slots:
          team_id: query.team_id
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users.info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get information about a user
      effect: read
      questions:
      - What is a user's timezone and are they an admin?
      - Can I get someone's profile details from their user ID?
      instructions:
      - text: Get information about user {user}.
        slots:
          user: query.user
      - text: Show the timezone and admin status of {user}.
        slots:
          user: query.user
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users.lookupByEmail'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a user by email address
      effect: read
      questions:
      - Which account belongs to a given email address?
      - What scope do I need to look people up by email?
      instructions:
      - text: Find the user whose email is {email}.
        slots:
          email: query.email
      - text: Get the user ID for {email}.
        slots:
          email: query.email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users.getPresence'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a user is online
      effect: read
      questions:
      - Is a teammate active right now or away?
      - Can I check someone's presence before messaging them?
      instructions:
      - text: Check the presence of user {user}.
        slots:
          user: query.user
      - text: Tell me whether {user} is online.
        slots:
          user: query.user
      method: generated
      generated: '2026-09-26'