# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure ManagedPrivateEndpointsClient Managed…
  version: 1.0.0
extends: openapi/microsoft-azure-managedprivateendpoints-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: 4
- target: $.paths['/managedVirtualNetworks/{managedVirtualNetworkName}/managedPrivateEndpoints/{managedPrivateEndpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Synapse managed private endpoint
      effect: read
      questions:
      - How do I check the approval state of a managed private endpoint in Synapse?
      - What resource does a given managed private endpoint connect to?
      instructions:
      - text: Get managed private endpoint {managedPrivateEndpointName} in network {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Show details of private endpoint {managedPrivateEndpointName} on {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedVirtualNetworks/{managedVirtualNetworkName}/managedPrivateEndpoints/{managedPrivateEndpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a managed private endpoint
      effect: write
      questions:
      - How do I privately connect my Synapse workspace to a storage account?
      - Can I add a managed private endpoint to a Synapse managed virtual network?
      instructions:
      - text: Create managed private endpoint {managedPrivateEndpointName} in {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Add private endpoint {managedPrivateEndpointName} to {managedVirtualNetworkName} with properties {properties}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedVirtualNetworks/{managedVirtualNetworkName}/managedPrivateEndpoints/{managedPrivateEndpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed private endpoint
      effect: destructive
      questions:
      - How do I remove a managed private endpoint from Synapse?
      - Will deleting a managed private endpoint break private connectivity to that resource?
      instructions:
      - text: Delete managed private endpoint {managedPrivateEndpointName} from {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Remove private endpoint {managedPrivateEndpointName} on network {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedVirtualNetworks/{managedVirtualNetworkName}/managedPrivateEndpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed private endpoints
      effect: read
      questions:
      - Which managed private endpoints are set up in my Synapse managed network?
      - Can I see all private endpoints in a managed virtual network?
      instructions:
      - text: List managed private endpoints in {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Show every private endpoint on managed network {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'