# 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 DataShareManagementClient Invitation API
  version: 1.0.0
extends: openapi/microsoft-azure-invitation-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an invitation to a data share
      effect: read
      questions:
      - How do I check an invitation I sent for a data share?
      - Has my Data Share invitation been accepted yet?
      instructions:
      - text: Show invitation {invitationName} in share {shareName} under subscription {sub}.
        slots:
          invitationName: path.invitationName
          shareName: path.shareName
          sub: path.subscriptionId
      - text: Get invitation {invitationName} on share {shareName} in account {accountName}, group {rg}.
        slots:
          invitationName: path.invitationName
          shareName: path.shareName
          accountName: path.accountName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Invite a recipient to a data share
      effect: write
      questions:
      - How do I invite someone to receive my Azure Data Share?
      - Can I send a share invitation to a specific recipient?
      instructions:
      - text: Send invitation {invitationName} for share {shareName} in account {accountName}, group {rg}, subscription {sub}.
        slots:
          invitationName: path.invitationName
          shareName: path.shareName
          accountName: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Invite a recipient to share {shareName} with invitation properties {properties}.
        slots:
          shareName: path.shareName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data share invitation
      effect: destructive
      questions:
      - How do I withdraw an invitation I sent for a data share?
      - Can I cancel a pending share invitation?
      instructions:
      - text: Delete invitation {invitationName} from share {shareName} in subscription {sub}.
        slots:
          invitationName: path.invitationName
          shareName: path.shareName
          sub: path.subscriptionId
      - text: Withdraw invitation {invitationName} on share {shareName} in account {accountName}, group {rg}.
        slots:
          invitationName: path.invitationName
          shareName: path.shareName
          accountName: path.accountName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations'].get
  update:
    x-apievangelist-phrasing:
      intent: List invitations for a data share
      effect: read
      questions:
      - Who have I invited to a particular data share?
      - Can I filter or sort the invitations sent for one share?
      instructions:
      - text: List invitations for share {shareName} in account {accountName}, group {rg}, subscription {sub}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: List invitations on share {shareName} ordered by {orderby}.
        slots:
          shareName: path.shareName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'