# 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 Consumer…
  version: 1.0.0
extends: openapi/microsoft-azure-consumerinvitation-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: 3
- target: $.paths['/providers/Microsoft.DataShare/listInvitations'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Data Share invitations
      effect: read
      questions:
      - Which Azure Data Share invitations have been sent to me?
      - Can I page through pending data share invitations?
      instructions:
      - text: List my data share invitations.
      - text: Get the next page of invitations using skip token {skip_token}.
        slots:
          skip_token: query.$skipToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.DataShare/locations/{location}/consumerInvitations/{invitationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Data Share invitation
      effect: read
      questions:
      - How do I view the details of one data share invitation I received?
      - What does a consumer invitation tell me about the share being offered?
      instructions:
      - text: Get invitation {invitation_id} in location {location}.
        slots:
          invitation_id: path.invitationId
          location: path.location
      - text: Show who sent data share invitation {invitation_id} and what it offers, in {location}.
        slots:
          invitation_id: path.invitationId
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.DataShare/locations/{location}/rejectInvitation'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a Data Share invitation
      effect: destructive
      questions:
      - How do I decline a data share invitation I don't want?
      - Can a rejected data share invitation be accepted later?
      instructions:
      - text: Reject the invitation described by {properties} in location {location}.
        slots:
          properties: requestBody.properties
          location: path.location
      - text: Decline data share invitation {properties} in {location}.
        slots:
          properties: requestBody.properties
          location: path.location
      method: generated
      generated: '2026-09-26'