# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Dataverse Web Metadata API
  version: 1.0.0
extends: openapi/power-platform-metadata-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: 3
- target: $.paths['/EntityDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Dataverse table definitions
      effect: read
      questions:
      - What tables exist in my Dataverse environment?
      - Can I get the metadata for every entity at once?
      instructions:
      - text: List all table definitions in Dataverse.
      - text: Show the entity definitions for every table.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EntityDefinitions(LogicalName=\'{logicalName}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metadata for one Dataverse table
      effect: read
      questions:
      - How do I read the schema of a single Dataverse table?
      - Where do I find a table's metadata by its logical name?
      instructions:
      - text: Get the table definition for {logicalName}.
        slots:
          logicalName: path.logicalName
      - text: Show metadata for the {logicalName} entity.
        slots:
          logicalName: path.logicalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/WhoAmI'].get
  update:
    x-apievangelist-phrasing:
      intent: Identify the signed-in Dataverse user
      effect: read
      questions:
      - Which user am I authenticated as against Dataverse?
      - How can I check my own user ID in the current session?
      instructions:
      - text: Tell me who I'm signed in as.
      - text: Return the current authenticated user's identity.
      method: generated
      generated: '2026-09-26'