# 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 Service Fabric Client Mesh Secret Values API
  version: 1.0.0
extends: openapi/microsoft-azure-meshsecretvalues-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: 5
- target: $.paths['/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get info about a secret value version
      effect: read
      questions:
      - How do I check metadata for one version of a Service Fabric Mesh secret without exposing it?
      - Does fetching a secret value resource return the actual secret?
      instructions:
      - text: Get info about value {value_name} of secret {secret_name}, without the secret itself.
        slots:
          value_name: path.secretValueResourceName
          secret_name: path.secretResourceName
      - text: Show the metadata of secret version {value_name}.
        slots:
          value_name: path.secretValueResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a new version value to a secret
      effect: write
      questions:
      - How do I add a new version to a Mesh secret?
      - Can a secret value be changed after I create it?
      instructions:
      - text: Add value {value_name} as a new version of secret {secret_name} using {description}.
        slots:
          value_name: path.secretValueResourceName
          secret_name: path.secretResourceName
          description: body.secretValueResourceDescription
      - text: Create secret version {value_name} for {secret_name}.
        slots:
          value_name: path.secretValueResourceName
          secret_name: path.secretResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a version of a secret
      effect: destructive
      questions:
      - How do I delete an old version of a Mesh secret?
      - Why would deleting a secret value fail?
      instructions:
      - text: Delete value {value_name} of secret {secret_name}.
        slots:
          value_name: path.secretValueResourceName
          secret_name: path.secretResourceName
      - text: Remove secret version {value_name} if it is not in use.
        slots:
          value_name: path.secretValueResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Secrets/{secretResourceName}/values'].get
  update:
    x-apievangelist-phrasing:
      intent: List the versions of a secret
      effect: read
      questions:
      - What versions exist for a given Service Fabric Mesh secret?
      - Can I list secret value names without seeing the values?
      instructions:
      - text: List all value versions of secret {secret_name}.
        slots:
          secret_name: path.secretResourceName
      - text: Show the names of every stored version under secret {secret_name}.
        slots:
          secret_name: path.secretResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}/list_value'].post
  update:
    x-apievangelist-phrasing:
      intent: Reveal the decrypted value of a secret version
      effect: read
      questions:
      - How do I read the actual decrypted contents of a Mesh secret version?
      - Is revealing a secret's plaintext value a privileged action?
      instructions:
      - text: Reveal the decrypted value of version {value_name} of secret {secret_name}.
        slots:
          value_name: path.secretValueResourceName
          secret_name: path.secretResourceName
      - text: Show me the plaintext of secret {secret_name} version {value_name}.
        slots:
          secret_name: path.secretResourceName
          value_name: path.secretValueResourceName
      method: generated
      generated: '2026-09-26'