# 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-listmanagementimagelists-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['/contentmoderator/lists/v1.0/imagelists/{listId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an image list's details
      effect: read
      questions:
      - What are the name and metadata of a Content Moderator image list?
      - Can I look up one custom image list by its ID?
      instructions:
      - text: Get the details of image list {list}.
        slots:
          list: path.listId
      - text: Show Content Moderator image list {list}.
        slots:
          list: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an image list
      effect: write
      questions:
      - How do I rename or change the description of an image list?
      - Can I update the metadata on an existing Content Moderator image list?
      instructions:
      - text: Update image list {list} with {details}.
        slots:
          list: path.listId
          details: body.body
      - text: Change the name and description of image list {list} to {details}.
        slots:
          list: path.listId
          details: body.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an image list
      effect: destructive
      questions:
      - Can I delete a custom image list I no longer moderate against?
      - What happens to the images in a Content Moderator list when I delete it?
      instructions:
      - text: Delete image list {list}.
        slots:
          list: path.listId
      - text: Remove Content Moderator image list {list} permanently.
        slots:
          list: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists'].get
  update:
    x-apievangelist-phrasing:
      intent: List all image lists
      effect: read
      questions:
      - Which custom image lists do I have in Content Moderator?
      - Can I see all my image lists in one call?
      instructions:
      - text: List all my image lists.
      - text: Show every Content Moderator image list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an image list
      effect: write
      questions:
      - How do I create a new custom image list for content moderation?
      - What do I need to supply when creating an image list?
      instructions:
      - text: Create an image list with {details}.
        slots:
          details: body.body
      - text: Make a new Content Moderator image list named and described by {details}.
        slots:
          details: body.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/imagelists/{listId}/RefreshIndex'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh an image list's search index
      effect: write
      questions:
      - Why do I need to refresh the index after adding images to a list?
      - How do I make newly added images in a list available for matching?
      instructions:
      - text: Refresh the index of image list {list}.
        slots:
          list: path.listId
      - text: Rebuild the search index for Content Moderator image list {list}.
        slots:
          list: path.listId
      method: generated
      generated: '2026-09-26'