# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure MicrosoftScanningClient Azure Key Vaults API
  version: 1.0.0
extends: openapi/microsoft-azure-azurekeyvaults-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: 4
- target: $.paths['/azureKeyVaults/{azureKeyVaultName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Key Vault connection
      effect: read
      questions:
      - How do I see the details of one Azure Key Vault connection on my account?
      - Which vault URL does a named Key Vault connection point to?
      instructions:
      - text: Get Key Vault connection {azureKeyVaultName}.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
      - text: Show the vault behind connection {azureKeyVaultName}.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/azureKeyVaults/{azureKeyVaultName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Connect an Azure Key Vault to the account
      effect: write
      questions:
      - How do I connect an Azure Key Vault so its secrets can be used as credentials?
      - Can I register a new Key Vault connection on my account?
      instructions:
      - text: Create Key Vault connection {azureKeyVaultName}.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
      - text: Add Key Vault connection {azureKeyVaultName} with properties {properties}.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/azureKeyVaults/{azureKeyVaultName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Key Vault connection
      effect: destructive
      questions:
      - How do I disconnect an Azure Key Vault from my account?
      - Can I remove a Key Vault connection I no longer use?
      instructions:
      - text: Delete Key Vault connection {azureKeyVaultName}.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
      - text: Disconnect the {azureKeyVaultName} vault from the account.
        slots:
          azureKeyVaultName: path.azureKeyVaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/azureKeyVaults'].get
  update:
    x-apievangelist-phrasing:
      intent: List Key Vault connections on the account
      effect: read
      questions:
      - Which Azure Key Vaults are connected to my account?
      - Can I see all Key Vault connections at once?
      instructions:
      - text: List all Key Vault connections in my account.
      - text: Show connected Key Vaults using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'