# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for PowerPlatform Private Endpoint Connections API
  version: 1.0.0
extends: openapi/power-platform-private-endpoint-connections-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/enterprisePolicies/{enterprisePolicyName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on a policy
      effect: read
      questions:
      - Which private endpoint connections are attached to an enterprise policy?
      - Can I see all pending and approved private endpoints for one policy?
      instructions:
      - text: List private endpoint connections on enterprise policy {enterprisePolicyName}.
        slots:
          enterprisePolicyName: path.enterprisePolicyName
      - text: Show every private endpoint connected to policy {enterprisePolicyName}.
        slots:
          enterprisePolicyName: path.enterprisePolicyName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/enterprisePolicies/{enterprisePolicyName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private endpoint connection
      effect: read
      questions:
      - What is the approval state of a specific private endpoint connection?
      - How do I look up one private endpoint connection by name?
      instructions:
      - text: Get private endpoint connection {privateEndpointConnectionName} on policy {enterprisePolicyName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
      - text: Show the status of connection {privateEndpointConnectionName} for {enterprisePolicyName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/enterprisePolicies/{enterprisePolicyName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a private endpoint connection
      effect: write
      questions:
      - How do I approve a private endpoint request against my enterprise policy?
      - Can I reject a private endpoint connection someone requested?
      instructions:
      - text: Approve private endpoint connection {privateEndpointConnectionName} on policy {enterprisePolicyName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
      - text: Set connection {privateEndpointConnectionName} on {enterprisePolicyName} to {properties}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/enterprisePolicies/{enterprisePolicyName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a private endpoint connection
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from an enterprise policy?
      - Can I delete a private endpoint connection by its name?
      instructions:
      - text: Delete private endpoint connection {privateEndpointConnectionName} from policy {enterprisePolicyName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
      - text: Remove connection {privateEndpointConnectionName} on {enterprisePolicyName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          enterprisePolicyName: path.enterprisePolicyName
      method: generated
      generated: '2026-10-01'