# 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 DataPlaneAccountClient Contact Assignment…
  version: 1.0.0
extends: openapi/microsoft-azure-contactassignment-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['/contactAssignments/{contactAssignmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contact assignment
      effect: read
      questions:
      - Who is assigned as a contact through a particular contact assignment?
      - Can I look up one contact assignment by its ID?
      instructions:
      - text: Get contact assignment {assignment}.
        slots:
          assignment: path.contactAssignmentId
      - text: Show the principal and contact group for assignment {assignment}.
        slots:
          assignment: path.contactAssignmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactAssignments/{contactAssignmentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a contact assignment
      effect: write
      questions:
      - How do I assign a person as a contact at a given scope?
      - Can I change which contact group an existing assignment belongs to?
      instructions:
      - text: Assign principal {principal} to contact group {contact_group} via assignment {assignment}.
        slots:
          principal: requestBody.principalId
          contact_group: requestBody.contactGroup
          assignment: path.contactAssignmentId
      - text: Set the scope of contact assignment {assignment} to {scope}.
        slots:
          assignment: path.contactAssignmentId
          scope: requestBody.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactAssignments/{contactAssignmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a contact assignment
      effect: destructive
      questions:
      - Can I remove a contact assignment that's no longer valid?
      - How do I unassign someone as a contact?
      instructions:
      - text: Delete contact assignment {assignment}.
        slots:
          assignment: path.contactAssignmentId
      - text: Remove the contact assignment {assignment} from the account.
        slots:
          assignment: path.contactAssignmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List contact assignments in the account
      effect: read
      questions:
      - Which contact assignments exist in my account?
      - Can I filter contact assignments by scope or contact group definition?
      instructions:
      - text: List all contact assignments in the account.
      - text: List contact assignments for scope {scope} in contact group definition {definition}.
        slots:
          scope: query.scope
          definition: query.contactGroupDefinition
      method: generated
      generated: '2026-09-26'
- target: $.paths['/getScopedContactGroupNames'].get
  update:
    x-apievangelist-phrasing:
      intent: List contact group names for a scope
      effect: read
      questions:
      - What contact group names are used within a given scope?
      - Can I get the distinct contact group names by reference type?
      instructions:
      - text: Get the distinct contact group names for scope {scope}.
        slots:
          scope: query.scope
      - text: List contact group names used at scope {scope} for reference type {reference_type}.
        slots:
          scope: query.scope
          reference_type: query.referenceType
      method: generated
      generated: '2026-09-26'