# 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 Text Moderation API
  version: 1.0.0
extends: openapi/microsoft-azure-textmoderation-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: 2
- target: $.paths['/contentmoderator/moderate/v1.0/ProcessText/Screen/'].post
  update:
    x-apievangelist-phrasing:
      intent: Screen text for profanity and blocklist matches
      effect: read
      questions:
      - How do I check user comments for profanity before publishing them?
      - Can I screen text against my own custom blocklist and detect personal data at the same time?
      - What's the maximum length of text I can send for moderation?
      instructions:
      - text: 'Screen this text for profanity: {text}.'
        slots:
          text: body.Text Content
      - text: Check {text} against custom blocklist {list_id} and flag any PII ({pii}).
        slots:
          text: body.Text Content
          list_id: query.listId
          pii: query.PII
      - text: Moderate {text} in language {language} with classification turned on ({classify}).
        slots:
          text: body.Text Content
          language: query.language
          classify: query.classify
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contentmoderator/moderate/v1.0/ProcessText/DetectLanguage'].post
  update:
    x-apievangelist-phrasing:
      intent: Detect the language of a text
      effect: read
      questions:
      - How can I find out what language a piece of user text is written in?
      - Which language code format is returned when detecting the predominant language?
      instructions:
      - text: Detect the language of {text}.
        slots:
          text: body.Text Content
      - text: Return the ISO 639-3 code for the main language in {text}.
        slots:
          text: body.Text Content
      method: generated
      generated: '2026-09-26'