API Evangelist conversational phrasing for Wso2 Applications 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 Applications API
  version: 1.0.0
extends: openapi/wso2-applications-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: 6
- target: $.paths['/applications/{applicationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application's details
      effect: read
      questions:
      - What are the settings of one of my applications?
      - Can I look up an application by its ID?
      instructions:
      - text: Show the details of application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Get application {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an application
      effect: write
      questions:
      - Can I rename one of my applications or change its tier?
      - How do I update the description of an existing application?
      instructions:
      - text: Rename application {applicationId} to {name} on tier {throttlingPolicy}.
        slots:
          applicationId: path.applicationId
          name: requestBody.name
          throttlingPolicy: requestBody.throttlingPolicy
      - text: Update app {applicationId} ({name}, tier {throttlingPolicy}) with description {description}.
        slots:
          applicationId: path.applicationId
          name: requestBody.name
          throttlingPolicy: requestBody.throttlingPolicy
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application
      effect: destructive
      questions:
      - Can I delete an application I no longer use?
      - What's the way to remove an app from the developer portal?
      instructions:
      - text: Delete application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Remove app {applicationId} from my account.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List or search my applications
      effect: read
      questions:
      - Which applications do I have in the developer portal?
      - Can I search my applications by name and sort the results?
      instructions:
      - text: List my applications.
      - text: Search my applications for {query}.
        slots:
          query: query.query
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new application
      effect: write
      questions:
      - How do I create a new application to subscribe to APIs?
      - Which throttling tier does a new application need?
      instructions:
      - text: Create an application called {name} on tier {throttlingPolicy}.
        slots:
          name: requestBody.name
          throttlingPolicy: requestBody.throttlingPolicy
      - text: Make a new app {name} with tier {throttlingPolicy} and token type {tokenType}.
        slots:
          name: requestBody.name
          throttlingPolicy: requestBody.throttlingPolicy
          tokenType: requestBody.tokenType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/reset-throttle-policy'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset an app's throttle for a user
      effect: write
      questions:
      - Can I reset the application-level throttle counter for a specific user?
      - What can I do when a user has hit my app's rate limit?
      instructions:
      - text: Reset the throttle policy of application {applicationId} for user {userName}.
        slots:
          applicationId: path.applicationId
          userName: requestBody.userName
      - text: Clear the application-level throttling on app {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'