# 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 Purview Share Client Sent Share Invitation…
  version: 1.0.0
extends: openapi/microsoft-azure-sentshareinvitation-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['/sentShares/{sentShareId}/sentShareInvitations'].get
  update:
    x-apievangelist-phrasing:
      intent: List invitations for a sent share
      effect: read
      questions:
      - Who has been invited to a data share I sent?
      - Can I filter or sort the recipient list of a sent share?
      instructions:
      - text: List invitations for sent share {sentShareId}.
        slots:
          sentShareId: path.sentShareId
      - text: List recipients of sent share {sentShareId} matching {filter}, ordered by {orderby}.
        slots:
          sentShareId: path.sentShareId
          filter: query.filter
          orderby: query.orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sentShares/{sentShareId}/sentShareInvitations/{sentShareInvitationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sent share invitation
      effect: read
      questions:
      - How do I look up one recipient invitation on a sent share?
      - What's the status of a particular share invitation?
      instructions:
      - text: Get invitation {sentShareInvitationId} on sent share {sentShareId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          sentShareId: path.sentShareId
      - text: Show recipient invitation {sentShareInvitationId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sentShares/{sentShareId}/sentShareInvitations/{sentShareInvitationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Invite a recipient to a sent share
      effect: write
      questions:
      - How do I invite someone to receive a data share?
      - Can I invite a service as well as a user to a share?
      instructions:
      - text: Create invitation {sentShareInvitationId} on sent share {sentShareId} of kind {invitationKind}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          sentShareId: path.sentShareId
          invitationKind: requestBody.invitationKind
      - text: Invite a recipient of kind {invitationKind} to share {sentShareId} as {sentShareInvitationId}.
        slots:
          invitationKind: requestBody.invitationKind
          sentShareId: path.sentShareId
          sentShareInvitationId: path.sentShareInvitationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sentShares/{sentShareId}/sentShareInvitations/{sentShareInvitationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a sent share invitation
      effect: destructive
      questions:
      - Can I withdraw an invitation I sent for a data share?
      - What happens to a recipient's access when their invitation is deleted?
      instructions:
      - text: Delete invitation {sentShareInvitationId} from sent share {sentShareId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          sentShareId: path.sentShareId
      - text: Revoke recipient invitation {sentShareInvitationId} on share {sentShareId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          sentShareId: path.sentShareId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sentShares/{sentShareId}/sentShareInvitations/{sentShareInvitationId}:notify'].post
  update:
    x-apievangelist-phrasing:
      intent: Notify a user recipient of a share invitation
      effect: write
      questions:
      - How do I resend the notification for a user share invitation?
      - Does notification work for service invitations too?
      instructions:
      - text: Notify the recipient of invitation {sentShareInvitationId} on sent share {sentShareId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          sentShareId: path.sentShareId
      - text: Send the invitation email for {sentShareInvitationId} with repeatability id {requestId}.
        slots:
          sentShareInvitationId: path.sentShareInvitationId
          requestId: header.repeatability-request-id
      method: generated
      generated: '2026-09-26'