# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Merged Plugins Config API
  version: 1.0.0
extends: openapi/harness-mergedpluginsconfig-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: 3
- target: $.paths['/v1/merged-plugins-config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get merged config of enabled IDP plugins
      effect: read
      questions:
      - What is the combined configuration of all plugins enabled in my developer portal?
      - Can I see the merged plugin config for my account?
      instructions:
      - text: Show the merged config for my enabled plugins.
      - text: Get the merged plugins config for account {account}.
        slots:
          account: header.Harness-Account
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sync-app-config'].put
  update:
    x-apievangelist-phrasing:
      intent: Sync the merged app-config for an account
      effect: write
      questions:
      - How does a support user resync the developer portal app-config for an account?
      - Can I rebuild the merged app-config from a base config?
      instructions:
      - text: Sync the app-config for account {account}.
        slots:
          account: header.Harness-Account
      - text: Resync the merged app-config using base config {base}.
        slots:
          base: query.base_config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/configuration-entities'].put
  update:
    x-apievangelist-phrasing:
      intent: Update portal env variables and proxy settings
      effect: write
      questions:
      - How do I set environment variables and proxy entries on the portal configuration screen?
      - Can I update the proxy settings used by developer portal plugins?
      instructions:
      - text: Update configuration entities with env variables {env} and proxy {proxy}.
        slots:
          env: requestBody.env_variables
          proxy: requestBody.proxy
      - text: Set the plugin proxy configuration to {proxy} and env variables to {env}.
        slots:
          proxy: requestBody.proxy
          env: requestBody.env_variables
      method: generated
      generated: '2026-09-26'