# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Slack Apps Applications API
  version: 1.0.0
extends: openapi/slack-applications-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: 8
- target: $.paths['/apps.event.authorizations.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List app installations that can see an event
      effect: read
      questions:
      - Which installations of my app is a given event visible to?
      - How do I find the authorizations behind an event context in Slack?
      instructions:
      - text: List the authorizations for event context {event_context}.
        slots:
          event_context: query.event_context
      - text: Show up to {limit} app installations that can see event {event_context}.
        slots:
          limit: query.limit
          event_context: query.event_context
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the permissions my app has on a team
      effect: read
      questions:
      - What permissions does my app currently hold on this workspace?
      - Can I get an overview of my app's permission info in one call?
      instructions:
      - text: Show the permissions info for my app on this team.
      - text: Get the permissions my app has using token {token}.
        slots:
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.request'].get
  update:
    x-apievangelist-phrasing:
      intent: Request additional scopes for my app
      effect: write
      questions:
      - Can my app ask a user for extra scopes after it's installed?
      - What do I need to trigger an additional scope request?
      instructions:
      - text: Request scopes {scopes} using trigger {trigger_id}.
        slots:
          scopes: query.scopes
          trigger_id: query.trigger_id
      - text: Ask the workspace to grant my app {scopes}, triggered by {trigger_id}.
        slots:
          scopes: query.scopes
          trigger_id: query.trigger_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.resources.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource grants my app holds
      effect: read
      questions:
      - Which channels and other resources has my app been granted access to?
      - Is the list of resource grants paginated?
      instructions:
      - text: List the resource grants my app has on this team with token {token}.
        slots:
          token: query.token
      - text: Show {limit} resource grants from cursor {cursor} using token {token}.
        slots:
          limit: query.limit
          cursor: query.cursor
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.scopes.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List scopes my app has on a team
      effect: read
      questions:
      - What OAuth scopes has my app been granted on this team?
      - Can I check which scopes are active before calling a method?
      instructions:
      - text: List the scopes granted to my app with token {token}.
        slots:
          token: query.token
      - text: Show my app's current scope list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.users.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List user grants and their scopes
      effect: read
      questions:
      - Which users have granted my app user-level scopes?
      - How do I page through my app's user grants?
      instructions:
      - text: List user grants and scopes for my app with token {token}.
        slots:
          token: query.token
      - text: Show {limit} user grants starting at cursor {cursor}, token {token}.
        slots:
          limit: query.limit
          cursor: query.cursor
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.permissions.users.request'].get
  update:
    x-apievangelist-phrasing:
      intent: Ask a user to grant user-level scopes
      effect: write
      questions:
      - Can my app pop up a permissions modal asking one user for a user scope?
      - What's required to request a user token scope from a specific person?
      instructions:
      - text: Ask user {user} to grant {scopes} via trigger {trigger_id}.
        slots:
          user: query.user
          scopes: query.scopes
          trigger_id: query.trigger_id
      - text: Open a user permissions modal for {user} requesting {scopes}, trigger {trigger_id}.
        slots:
          user: query.user
          scopes: query.scopes
          trigger_id: query.trigger_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apps.uninstall'].get
  update:
    x-apievangelist-phrasing:
      intent: Uninstall my app from a workspace
      effect: destructive
      questions:
      - How do I uninstall my app from a workspace programmatically?
      - Does uninstalling the app need its client ID and secret?
      instructions:
      - text: Uninstall my app from this workspace.
      - text: Uninstall the app with client ID {client_id} and secret {client_secret}.
        slots:
          client_id: query.client_id
          client_secret: query.client_secret
      method: generated
      generated: '2026-09-26'