# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure AccessControlClient Synapse Role…
  version: 1.0.0
extends: openapi/microsoft-azure-synapseroledefinitions-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: 2
- target: $.paths['/roleDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Synapse RBAC role definitions
      effect: read
      questions:
      - Which Synapse roles can I assign to users in my workspace?
      - Can I list only the built-in Synapse role definitions?
      instructions:
      - text: List Synapse role definitions where built-in is {isBuiltIn}.
        slots:
          isBuiltIn: query.isBuiltIn
      - text: Show Synapse roles available at scope {scope}.
        slots:
          scope: query.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/roleDefinitions/{roleDefinitionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Synapse role definition
      effect: read
      questions:
      - What permissions does a particular Synapse role grant?
      - How do I look up a Synapse role definition by its ID?
      instructions:
      - text: Get Synapse role definition {roleDefinitionId}.
        slots:
          roleDefinitionId: path.roleDefinitionId
      - text: Show the actions allowed by role {roleDefinitionId}.
        slots:
          roleDefinitionId: path.roleDefinitionId
      method: generated
      generated: '2026-09-26'