# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.SignIns Identity Protection.identity Protection…
  version: 1.0.0
extends: openapi/azure-ad-identityprotection-identityprotectionroot-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/identityProtection'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the identity protection root
      effect: read
      questions:
      - What risk data does Entra ID Protection expose at its top level?
      - Can I read risky users and risk detections from the identity protection root in one call?
      instructions:
      - text: Show the identity protection root object.
      - text: Get identityProtection with its risky users and risk detections.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityProtection'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the identity protection root
      effect: write
      questions:
      - How do I patch the identity protection root object?
      - Can I replace the risky service principals collection on identity protection?
      instructions:
      - text: Update identityProtection with risky users {risky_users}.
        slots:
          risky_users: requestBody.riskyUsers
      - text: Patch the identity protection root setting risk detections to {detections}.
        slots:
          detections: requestBody.riskDetections
      method: generated
      generated: '2026-10-01'