API Evangelist conversational phrasing for Power BI REST Datasets API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Power BI REST Datasets API
  version: 1.0.0
extends: openapi/power-bi-datasets-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: 10
- target: $.paths['/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List datasets in My Workspace
      effect: read
      questions:
      - What datasets are in my personal My Workspace?
      - Which of my datasets are push datasets and which are refreshable?
      instructions:
      - text: List the datasets in My Workspace.
      - text: Show me which of my My Workspace datasets can be refreshed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a push dataset
      effect: write
      questions:
      - How do I create a push dataset so my app can stream rows into Power BI?
      - Can I define tables and relationships when creating a real-time dataset?
      - Is there a way to set a retention policy on a new push dataset?
      instructions:
      - text: Create a push dataset named {name} with tables {tables}.
        slots:
          name: requestBody.name
          tables: requestBody.tables
      - text: Create push dataset {name} with tables {tables} and retention policy {defaultRetentionPolicy}.
        slots:
          name: requestBody.name
          tables: requestBody.tables
          defaultRetentionPolicy: query.defaultRetentionPolicy
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset's details
      effect: read
      questions:
      - How can I see the tables and configuration of one dataset?
      - What data source details does a specific dataset have?
      instructions:
      - text: Get dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Show me the configuration and tables of dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dataset
      effect: destructive
      questions:
      - How do I delete a dataset from My Workspace?
      - Does removing a dataset also delete the reports and tiles built on it?
      instructions:
      - text: Delete dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Remove dataset {datasetId} along with its dependent reports and tiles.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}/refreshes'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a dataset's refresh history
      effect: read
      questions:
      - Did my dataset's last refresh succeed or fail?
      - When did a dataset's recent refreshes start and finish?
      - Can I limit refresh history to just the most recent few runs?
      instructions:
      - text: Show the refresh history of dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Get the last {top} refreshes for dataset {datasetId}.
        slots:
          top: query.$top
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}/refreshes'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger a dataset refresh
      effect: write
      questions:
      - How do I kick off a refresh of a dataset on demand?
      - Can I refresh only specific tables or partitions instead of the whole dataset?
      - Is it possible to set a retry count when starting a refresh?
      instructions:
      - text: Refresh dataset {datasetId} now.
        slots:
          datasetId: path.datasetId
      - text: Refresh only {objects} in dataset {datasetId}.
        slots:
          objects: requestBody.objects
          datasetId: path.datasetId
      - text: Start a {type} refresh of dataset {datasetId} with {retryCount} retries.
        slots:
          type: requestBody.type
          datasetId: path.datasetId
          retryCount: requestBody.retryCount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}/datasources'].get
  update:
    x-apievangelist-phrasing:
      intent: List a dataset's data sources
      effect: read
      questions:
      - Which server and database does a dataset pull its data from?
      - What kinds of data sources is a given dataset connected to?
      instructions:
      - text: List the data sources of dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Show the connection details behind dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}/parameters'].get
  update:
    x-apievangelist-phrasing:
      intent: List a dataset's parameters
      effect: read
      questions:
      - What parameters does a dataset expose for its connections and queries?
      - Can I view the current parameter values on one dataset?
      instructions:
      - text: List the parameters of dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Show current parameter values for dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}/parameters'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a dataset's parameter values
      effect: write
      questions:
      - How do I change a dataset's parameter values, like pointing it at another server?
      - Do new parameter values take effect immediately or after a refresh?
      instructions:
      - text: Update the parameters of dataset {datasetId} with {updateDetails}.
        slots:
          datasetId: path.datasetId
          updateDetails: requestBody.updateDetails
      - text: Set new parameter values {updateDetails} on dataset {datasetId}.
        slots:
          updateDetails: requestBody.updateDetails
          datasetId: path.datasetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{groupId}/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List datasets in a workspace
      effect: read
      questions:
      - Which datasets are in a shared team workspace?
      - Can I list datasets for a workspace other than My Workspace?
      instructions:
      - text: List the datasets in workspace {groupId}.
        slots:
          groupId: path.groupId
      - text: Show all datasets inside the {groupId} workspace.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-10-01'