# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness App Config API
  version: 1.0.0
extends: openapi/harness-app-config-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: 2
- target: $.paths['/v1/plugin-toggle/{plugin-id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a Backstage plugin
      effect: write
      questions:
      - How do I turn on a Backstage plugin in my Harness developer portal?
      - Can I disable a Backstage plugin without deleting its config?
      instructions:
      - text: Enable Backstage plugin {plugin_id}.
        slots:
          plugin_id: path.plugin-id
      - text: Set plugin {plugin_id} enabled to {enabled}.
        slots:
          plugin_id: path.plugin-id
          enabled: query.enabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/app-config'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a Backstage plugin's app config
      effect: write
      questions:
      - Where do I put the app-config YAML a Backstage plugin needs?
      - Can I update the configuration of a plugin that's already set up?
      instructions:
      - text: Save the plugin app config {app_config}.
        slots:
          app_config: requestBody.app_config
      - text: Update the Backstage plugin configuration to {app_config}.
        slots:
          app_config: requestBody.app_config
      method: generated
      generated: '2026-10-01'