# 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 Blueprint API
  version: 1.0.0
extends: openapi/microsoft-azure-publishedblueprint-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['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions/{versionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a published blueprint version
      effect: read
      questions:
      - How do I read a specific published version of an Azure Blueprint?
      - What artifacts were locked into version 1.0 of my blueprint?
      instructions:
      - text: Get version {versionId} of blueprint {blueprintName} at scope {resourceScope}.
        slots:
          resourceScope: path.resourceScope
          blueprintName: path.blueprintName
          versionId: path.versionId
      - text: Show published blueprint {blueprintName} version {versionId}.
        slots:
          blueprintName: path.blueprintName
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions/{versionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a new blueprint version
      effect: write
      questions:
      - How do I publish my blueprint draft so it can be assigned?
      - Can a published blueprint version be edited later?
      instructions:
      - text: Publish blueprint {blueprintName} as version {versionId} at scope {resourceScope}.
        slots:
          resourceScope: path.resourceScope
          blueprintName: path.blueprintName
          versionId: path.versionId
      - text: Publish {blueprintName} version {versionId} with properties {properties}.
        slots:
          blueprintName: path.blueprintName
          versionId: path.versionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions/{versionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a published blueprint version
      effect: destructive
      questions:
      - How do I remove an old published version of a blueprint?
      - Can I delete one blueprint version while keeping the others?
      instructions:
      - text: Delete version {versionId} of blueprint {blueprintName} at scope {resourceScope}.
        slots:
          resourceScope: path.resourceScope
          blueprintName: path.blueprintName
          versionId: path.versionId
      - text: Remove published blueprint version {versionId}.
        slots:
          versionId: path.versionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List published versions of a blueprint
      effect: read
      questions:
      - Which versions of a blueprint have been published?
      - How do I see the publish history of an Azure Blueprint definition?
      instructions:
      - text: List published versions of blueprint {blueprintName} at scope {resourceScope}.
        slots:
          resourceScope: path.resourceScope
          blueprintName: path.blueprintName
      - text: Show every published version of {blueprintName}.
        slots:
          blueprintName: path.blueprintName
      method: generated
      generated: '2026-09-26'