# 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 Azure Container Registry Acr Metadata API
  version: 1.0.0
extends: openapi/microsoft-azure-acrmetadata-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: 6
- target: $.paths['/acr/v1/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a container registry repository's attributes
      effect: read
      questions:
      - How do I see the attributes of a repository in Azure Container Registry?
      - Is a given ACR repository locked against deletes or writes?
      instructions:
      - text: Get the attributes of repository {name}.
        slots:
          name: path.name
      - text: Show whether repository {name} allows delete, write, list and read.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acr/v1/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Lock or unlock a registry repository
      effect: write
      questions:
      - Can I stop anyone from deleting or overwriting images in an ACR repository?
      - How do I make a whole container repository read-only?
      instructions:
      - text: Set delete-enabled to {deleteEnabled} on repository {name}.
        slots:
          deleteEnabled: requestBody.deleteEnabled
          name: path.name
      - text: Lock repository {name} by setting write-enabled to {writeEnabled}.
        slots:
          name: path.name
          writeEnabled: requestBody.writeEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acr/v1/{name}/_tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags in a registry repository
      effect: read
      questions:
      - What image tags exist in my container repository?
      - Can I page through repository tags sorted by time or limited to one digest?
      instructions:
      - text: List the tags in repository {name}.
        slots:
          name: path.name
      - text: Show {n} tags from repository {name} ordered by {orderby}.
        slots:
          n: query.n
          name: path.name
          orderby: query.orderby
      - text: List tags in {name} that point at digest {digest}.
        slots:
          name: path.name
          digest: query.digest
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acr/v1/{name}/_tags/{reference}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the attributes of one image tag
      effect: read
      questions:
      - How do I read the metadata of a single tag in an ACR repository?
      - Which digest does a specific image tag point to, and is it locked?
      instructions:
      - text: Get the attributes of tag {reference} in repository {name}.
        slots:
          reference: path.reference
          name: path.name
      - text: Show the digest behind {name}:{reference}.
        slots:
          name: path.name
          reference: path.reference
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acr/v1/{name}/_tags/{reference}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an image tag
      effect: destructive
      questions:
      - How do I delete one tag from a container repository?
      - Can I untag an image in Azure Container Registry without deleting the whole repository?
      instructions:
      - text: Delete tag {reference} from repository {name}.
        slots:
          reference: path.reference
          name: path.name
      - text: Untag {name}:{reference}.
        slots:
          name: path.name
          reference: path.reference
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acr/v1/{name}/_tags/{reference}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the attributes of an image tag
      effect: write
      questions:
      - Can I lock a single image tag so it can't be overwritten or deleted?
      - How do I change the write or delete permissions on one ACR tag?
      instructions:
      - text: Update the attributes of tag {reference} in repository {name} to {value}.
        slots:
          reference: path.reference
          name: path.name
          value: body.value
      - text: Lock tag {name}:{reference} against changes.
        slots:
          name: path.name
          reference: path.reference
      method: generated
      generated: '2026-09-26'