# 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 Records API
  version: 1.0.0
extends: openapi/power-platform-records-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: 5
- target: $.paths['/{entitySetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Query records from a Dataverse table
      effect: read
      questions:
      - How do I pull rows out of a Dataverse table?
      - Can I filter, sort and pick columns when querying Dataverse records?
      - Is there a way to get a total count of matching rows in a table?
      instructions:
      - text: List records from the {entitySetName} table.
        slots:
          entitySetName: path.entitySetName
      - text: Query {entitySetName} where {filter}, sorted by {orderby}.
        slots:
          entitySetName: path.entitySetName
          filter: query.$filter
          orderby: query.$orderby
      - text: Get the top {top} rows of {entitySetName} with only columns {select}.
        slots:
          top: query.$top
          entitySetName: path.entitySetName
          select: query.$select
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{entitySetName}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a record in a Dataverse table
      effect: write
      questions:
      - How do I add a new row to a Dataverse table?
      - Can I insert a record into any table by its entity set name?
      instructions:
      - text: Create a new record in the {entitySetName} table.
        slots:
          entitySetName: path.entitySetName
      - text: Add a row to {entitySetName}.
        slots:
          entitySetName: path.entitySetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{entitySetName}({id})'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a single Dataverse record by id
      effect: read
      questions:
      - How do I fetch one Dataverse row when I know its GUID?
      - Can I choose which columns come back for a single record?
      instructions:
      - text: Get record {id} from {entitySetName}.
        slots:
          id: path.id
          entitySetName: path.entitySetName
      - text: Fetch columns {select} of record {id} in {entitySetName}.
        slots:
          select: query.$select
          id: path.id
          entitySetName: path.entitySetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{entitySetName}({id})'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Dataverse record
      effect: destructive
      questions:
      - How do I remove a row from a Dataverse table?
      - Can I delete a single record by its id?
      instructions:
      - text: Delete record {id} from the {entitySetName} table.
        slots:
          id: path.id
          entitySetName: path.entitySetName
      - text: Remove the {entitySetName} row with id {id}.
        slots:
          entitySetName: path.entitySetName
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{entitySetName}({id})'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update or upsert a Dataverse record
      effect: write
      questions:
      - How do I change fields on an existing Dataverse row?
      - Can I upsert a record so it's created if the id doesn't exist yet?
      instructions:
      - text: Update record {id} in {entitySetName}.
        slots:
          id: path.id
          entitySetName: path.entitySetName
      - text: Upsert the {entitySetName} row with id {id}.
        slots:
          entitySetName: path.entitySetName
          id: path.id
      method: generated
      generated: '2026-09-26'