# 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-listmanagementtermlists-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/termlists/{listId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get term list details
      effect: read
      questions:
      - What are the name and metadata of one Content Moderator term list?
      - Can I look up a custom term list by its ID?
      instructions:
      - text: Get details of term list {list}.
        slots:
          list: path.listId
      - text: Show the metadata for Content Moderator term list {list}.
        slots:
          list: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a term list
      effect: write
      questions:
      - Can I rename or change the description of an existing term list?
      - Is it possible to edit a term list's metadata?
      instructions:
      - text: Update term list {list}.
        slots:
          list: path.listId
      - text: Change the name and description of term list {list} to {details}.
        slots:
          list: path.listId
          details: body.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a term list
      effect: destructive
      questions:
      - Can I delete a custom term list from Content Moderator?
      - What happens to terms when I delete their list?
      instructions:
      - text: Delete term list {list}.
        slots:
          list: path.listId
      - text: Remove Content Moderator term list {list}.
        slots:
          list: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists'].get
  update:
    x-apievangelist-phrasing:
      intent: List all term lists
      effect: read
      questions:
      - Which custom term lists have I created for text moderation?
      - Can I see every term list in my Content Moderator resource?
      instructions:
      - text: List all my term lists.
      - text: Show every Content Moderator term list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a term list
      effect: write
      questions:
      - How do I create a custom list of blocked terms for text moderation?
      - Can I give a new term list a name and description?
      instructions:
      - text: Create a term list named {details}.
        slots:
          details: body.body
      - text: Create a new custom term list for screening text.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}/RefreshIndex'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a term list's search index
      effect: write
      questions:
      - Do I need to refresh the index after changing terms in a list?
      - Can I rebuild the index of a term list for a specific language?
      instructions:
      - text: Refresh the index of term list {list} for language {language}.
        slots:
          list: path.listId
          language: query.language
      - text: Rebuild term list {list} index in {language}.
        slots:
          list: path.listId
          language: query.language
      method: generated
      generated: '2026-09-26'