# 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 BlueprintClient Published Artifact API
  version: 1.0.0
extends: openapi/microsoft-azure-publishedartifact-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: 2
- target: $.paths['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions/{versionId}/artifacts/{artifactName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an artifact from a published blueprint version
      effect: read
      questions:
      - What does a specific artifact look like in a published blueprint version?
      - Can I inspect one policy or template artifact inside a blueprint release?
      instructions:
      - text: Get artifact {artifactName} from version {versionId} of blueprint {blueprintName} at scope {resourceScope}.
        slots:
          artifactName: path.artifactName
          versionId: path.versionId
          blueprintName: path.blueprintName
          resourceScope: path.resourceScope
      - text: Show published artifact {artifactName} in blueprint {blueprintName} version {versionId}.
        slots:
          artifactName: path.artifactName
          blueprintName: path.blueprintName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions/{versionId}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts in a published blueprint version
      effect: read
      questions:
      - Which artifacts are included in a published version of my blueprint?
      - Can I list blueprint artifacts at a management group or subscription scope?
      instructions:
      - text: List artifacts in version {versionId} of blueprint {blueprintName} at scope {resourceScope}.
        slots:
          versionId: path.versionId
          blueprintName: path.blueprintName
          resourceScope: path.resourceScope
      - text: Show everything published in blueprint {blueprintName} release {versionId}.
        slots:
          blueprintName: path.blueprintName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'