# 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 Data Policy Operations.data Policy…
  version: 1.0.0
extends: openapi/azure-ad-datapolicyoperations-datapolicyoperation-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: 6
- target: $.paths['/dataPolicyOperations'].get
  update:
    x-apievangelist-phrasing:
      intent: List data policy export operations
      effect: read
      questions:
      - What user data export requests have been submitted in my tenant?
      - Can I filter data policy operations by status?
      instructions:
      - text: List all data policy operations.
      - text: List data policy operations matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataPolicyOperations'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a new data policy operation
      effect: write
      questions:
      - Can I add a data policy operation entry for a user?
      - Is there a way to create a data policy operation record with a storage location?
      instructions:
      - text: Create a data policy operation for user {userId}.
        slots:
          userId: requestBody.userId
      - text: Add a data policy operation for user {userId} stored at {storageLocation}.
        slots:
          userId: requestBody.userId
          storageLocation: requestBody.storageLocation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataPolicyOperations/{dataPolicyOperation-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a data policy operation
      effect: read
      questions:
      - Has a specific user data export finished, and where is it stored?
      - How far along is a data policy operation I submitted?
      instructions:
      - text: Get data policy operation {operation}.
        slots:
          operation: path.dataPolicyOperation-id
      - text: Show the progress and storage location of data policy operation {operation}.
        slots:
          operation: path.dataPolicyOperation-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataPolicyOperations/{dataPolicyOperation-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data policy operation
      effect: destructive
      questions:
      - Can I remove a data policy operation record?
      - Is it possible to delete an export operation entry once it's done?
      instructions:
      - text: Delete data policy operation {operation}.
        slots:
          operation: path.dataPolicyOperation-id
      - text: Remove data policy operation {operation} if its ETag matches {etag}.
        slots:
          operation: path.dataPolicyOperation-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataPolicyOperations/{dataPolicyOperation-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a data policy operation
      effect: write
      questions:
      - Can I change the status or progress recorded on a data policy operation?
      - Is a data policy operation's storage location editable?
      instructions:
      - text: Set the status of data policy operation {operation} to {status}.
        slots:
          operation: path.dataPolicyOperation-id
          status: requestBody.status
      - text: Update data policy operation {operation} progress to {progress}.
        slots:
          operation: path.dataPolicyOperation-id
          progress: requestBody.progress
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataPolicyOperations/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count data policy operations
      effect: read
      questions:
      - How many data policy operations exist in the tenant?
      - Can I count only the export operations that match a filter?
      instructions:
      - text: Count all data policy operations.
      - text: Count data policy operations matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'