# 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 Content Moderator Client List Management…
  version: 1.0.0
extends: openapi/microsoft-azure-listmanagementimage-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['/contentmoderator/lists/v1.0/imagelists/{listId}/images'].get
  update:
    x-apievangelist-phrasing:
      intent: List image IDs in a moderation list
      effect: read
      questions:
      - Which images are in my custom Content Moderator image list?
      - Can I get all image IDs stored in one list?
      instructions:
      - text: Get all image IDs in image list {listId}.
        slots:
          listId: path.listId
      - text: Show which images are stored in moderation list {listId}.
        slots:
          listId: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}/images'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an image to a moderation list
      effect: write
      questions:
      - How do I add an image to a custom block list for moderation?
      - Can I tag and label an image when adding it to a list?
      instructions:
      - text: Add this image to image list {listId}.
        slots:
          listId: path.listId
      - text: Add this image to list {listId} with tag {tag} and label {label}.
        slots:
          listId: path.listId
          tag: query.tag
          label: query.label
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}/images'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete all images from a moderation list
      effect: destructive
      questions:
      - Can I clear every image out of an image list?
      - Can I empty a moderation image list in one call?
      instructions:
      - text: Delete all images from image list {listId}.
        slots:
          listId: path.listId
      - text: Empty moderation image list {listId} completely.
        slots:
          listId: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}/images/{ImageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one image from a moderation list
      effect: destructive
      questions:
      - Is it possible to remove a single image from a custom image list?
      - Can I delete one image by ID and keep the rest of the list?
      instructions:
      - text: Delete image {ImageId} from image list {listId}.
        slots:
          ImageId: path.ImageId
          listId: path.listId
      - text: Remove just image {ImageId} from moderation list {listId}.
        slots:
          ImageId: path.ImageId
          listId: path.listId
      method: generated
      generated: '2026-09-26'