API Evangelist conversational phrasing for WSO2 API Manager - Governance Rulesets 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 - Governance Rulesets API
  version: 1.0.0
extends: openapi/wso2-rulesets-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: 7
- target: $.paths['/rulesets'].get
  update:
    x-apievangelist-phrasing:
      intent: List governance rulesets
      effect: read
      questions:
      - What rulesets does my organization have for API governance?
      - Can I search rulesets by name and page through results?
      instructions:
      - text: List our governance rulesets.
      - text: Search rulesets matching {query}, returning {limit} at a time.
        slots:
          query: query.query
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a governance ruleset
      effect: write
      questions:
      - How do I upload a new linting ruleset for API definitions in WSO2?
      - Can I add a ruleset that validates async API artifacts?
      instructions:
      - text: Create a ruleset named {name} of type {ruleType} for {artifactType} artifacts with content {rulesetContent}.
        slots:
          name: requestBody.name
          ruleType: requestBody.ruleType
          artifactType: requestBody.artifactType
          rulesetContent: requestBody.rulesetContent
      - text: 'Add a new ruleset {name} from this YAML: {rulesetContent}, applying to {ruleType} on {artifactType}.'
        slots:
          name: requestBody.name
          rulesetContent: requestBody.rulesetContent
          ruleType: requestBody.ruleType
          artifactType: requestBody.artifactType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets/{rulesetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a ruleset's details
      effect: read
      questions:
      - What are the details and metadata of a specific ruleset?
      - Who provided a given ruleset and what artifact type does it check?
      instructions:
      - text: Get ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      - text: Show me the metadata for ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets/{rulesetId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing ruleset
      effect: write
      questions:
      - How do I change the rules inside a ruleset I already created?
      - Can I rename an existing ruleset and edit its documentation link?
      instructions:
      - text: Update ruleset {rulesetId} with new content {rulesetContent}, name {name}, type {ruleType}, artifact {artifactType}.
        slots:
          rulesetId: path.rulesetId
          rulesetContent: requestBody.rulesetContent
          name: requestBody.name
          ruleType: requestBody.ruleType
          artifactType: requestBody.artifactType
      - text: Rename existing ruleset {rulesetId} to {name}, keeping type {ruleType}, artifact {artifactType} and content {rulesetContent}.
        slots:
          rulesetId: path.rulesetId
          name: requestBody.name
          ruleType: requestBody.ruleType
          artifactType: requestBody.artifactType
          rulesetContent: requestBody.rulesetContent
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets/{rulesetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a ruleset
      effect: destructive
      questions:
      - How do I remove a ruleset we no longer use?
      - Can I delete a governance ruleset permanently?
      instructions:
      - text: Delete ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      - text: Remove the obsolete ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets/{rulesetId}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a ruleset's rule file
      effect: read
      questions:
      - Where can I read the raw YAML or JSON rules inside a ruleset?
      - Can I download the actual rule file content of a ruleset?
      instructions:
      - text: Get the rule file content of ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      - text: Download the raw rules for ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rulesets/{rulesetId}/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: See which policies use a ruleset
      effect: read
      questions:
      - Which governance policies depend on this ruleset?
      - Is a ruleset still referenced by any policy before I delete it?
      instructions:
      - text: List the policies that use ruleset {rulesetId}.
        slots:
          rulesetId: path.rulesetId
      - text: Check where ruleset {rulesetId} is used.
        slots:
          rulesetId: path.rulesetId
      method: generated
      generated: '2026-10-01'