API Evangelist conversational phrasing for WSO2 API Manager - Governance Governance Policies 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 Governance Policies API
  version: 1.0.0
extends: openapi/wso2-governance-policies-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['/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List governance policies
      effect: read
      questions:
      - What governance policies are defined for our organization?
      - Can I search governance policies by name?
      instructions:
      - text: List all governance policies.
      - text: Search governance policies matching {query}.
        slots:
          query: query.query
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a governance policy
      effect: write
      questions:
      - How do I create a governance policy that enforces rulesets on our APIs?
      - Can a new governance policy be tied to specific labels and lifecycle states?
      instructions:
      - text: Create a governance policy named {name} using rulesets {rulesets}.
        slots:
          name: requestBody.name
          rulesets: requestBody.rulesets
      - text: Create governance policy {name} enforced at {governableStates} for labels {labels} with actions {actions}.
        slots:
          name: requestBody.name
          governableStates: requestBody.governableStates
          labels: requestBody.labels
          actions: requestBody.actions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/{policyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a governance policy
      effect: read
      questions:
      - What rulesets, labels and actions does a specific governance policy have?
      - Can I look up one governance policy by its id?
      instructions:
      - text: Show governance policy {policyId}.
        slots:
          policyId: path.policyId
      - text: Get the details of governance policy {policyId}.
        slots:
          policyId: path.policyId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/{policyId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a governance policy
      effect: write
      questions:
      - How do I change the rulesets on an existing governance policy?
      - Can I change when an existing governance policy is enforced?
      instructions:
      - text: Update governance policy {policyId} to use rulesets {rulesets}.
        slots:
          policyId: path.policyId
          rulesets: requestBody.rulesets
      - text: Rename governance policy {policyId} to {name}.
        slots:
          policyId: path.policyId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/{policyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a governance policy
      effect: destructive
      questions:
      - How do I remove a governance policy we no longer need?
      - Can a governance policy be deleted by its id?
      instructions:
      - text: Delete governance policy {policyId}.
        slots:
          policyId: path.policyId
      - text: Remove the governance policy {policyId} from our organization.
        slots:
          policyId: path.policyId
      method: generated
      generated: '2026-10-01'