# 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-listmanagementterm-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/termlists/{listId}/terms/{term}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a term to a Content Moderator term list
      effect: write
      questions:
      - How do I add a custom blocked word to my Content Moderator term list?
      - Do I need to specify a language when adding a term to a list?
      instructions:
      - text: Add the term {term} in language {language} to term list {listId}.
        slots:
          term: path.term
          language: query.language
          listId: path.listId
      - text: Put {term} ({language}) on moderation list {listId}.
        slots:
          term: path.term
          language: query.language
          listId: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}/terms/{term}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one term from a term list
      effect: destructive
      questions:
      - Can I remove a single word from my Content Moderator term list?
      - How do I stop a specific term from being flagged without clearing the whole list?
      instructions:
      - text: Delete the term {term} in language {language} from term list {listId}.
        slots:
          term: path.term
          language: query.language
          listId: path.listId
      - text: Take {term} ({language}) off moderation list {listId}.
        slots:
          term: path.term
          language: query.language
          listId: path.listId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}/terms'].get
  update:
    x-apievangelist-phrasing:
      intent: List the terms in a term list
      effect: read
      questions:
      - What words are currently on my Content Moderator term list?
      - Can I page through the terms in a list with offset and limit?
      instructions:
      - text: List all {language} terms in term list {listId}.
        slots:
          language: query.language
          listId: path.listId
      - text: Show {limit} {language} terms from list {listId} starting at offset {offset}.
        slots:
          limit: query.limit
          language: query.language
          listId: path.listId
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/lists/v1.0/termlists/{listId}/terms'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all terms from a term list
      effect: destructive
      questions:
      - How do I empty a Content Moderator term list in one go?
      - Can I wipe every term of one language from a list?
      instructions:
      - text: Delete all {language} terms from term list {listId}.
        slots:
          language: query.language
          listId: path.listId
      - text: Empty moderation list {listId} of every {language} term.
        slots:
          listId: path.listId
          language: query.language
      method: generated
      generated: '2026-09-26'