API Evangelist conversational phrasing for WSO2 API Manager - Admin System Scopes API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSO2 API Manager - Admin System Scopes API
  version: 1.0.0
extends: openapi/wso2-system-scopes-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/system-scopes/{scopeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a user has a scope
      effect: read
      questions:
      - Does a particular user hold a given system scope?
      - Can I validate a scope name against a specific username?
      instructions:
      - text: Check whether user {username} has scope {scopeName}.
        slots:
          username: query.username
          scopeName: path.scopeName
      - text: Validate system scope {scopeName}.
        slots:
          scopeName: path.scopeName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/system-scopes'].get
  update:
    x-apievangelist-phrasing:
      intent: List role-to-scope mappings
      effect: read
      questions:
      - Which roles are mapped to each system scope in the tenant config?
      - What are the current role scope mappings for the admin dashboard?
      instructions:
      - text: List the role scope mappings.
      - text: Show which roles are assigned to each system scope.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/system-scopes'].put
  update:
    x-apievangelist-phrasing:
      intent: Update roles assigned to scopes
      effect: write
      questions:
      - How do I change which roles can use each system scope?
      - Can I update the role mappings for all scopes in one request?
      instructions:
      - text: Update the role mappings for all scopes to {list}.
        slots:
          list: requestBody.list
      - text: Replace the scope-to-role assignments with {list}.
        slots:
          list: requestBody.list
      method: generated
      generated: '2026-10-01'
- target: $.paths['/system-scopes/role-aliases'].get
  update:
    x-apievangelist-phrasing:
      intent: List role alias mappings
      effect: read
      questions:
      - Which role aliases are mapped to the system scope roles?
      - Can I see the current role alias configuration?
      instructions:
      - text: List the role alias mappings.
      - text: Show which roles are aliased for system scopes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/system-scopes/role-aliases'].put
  update:
    x-apievangelist-phrasing:
      intent: Add role alias mappings
      effect: write
      questions:
      - Can I alias one role to another for system scope checks?
      - How do I add a new role alias mapping?
      instructions:
      - text: Set the role alias mappings to {list}.
        slots:
          list: requestBody.list
      - text: Add role aliases {list} for system scope roles.
        slots:
          list: requestBody.list
      method: generated
      generated: '2026-10-01'