# 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 ManagementLinkClient Resource Links API
  version: 1.0.0
extends: openapi/microsoft-azure-resource-links-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/{linkId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource link
      effect: read
      questions:
      - How do I look up a single resource link by its ID?
      - What source and target does an Azure resource link connect?
      instructions:
      - text: Show resource link {linkId}.
        slots:
          linkId: path.linkId
      - text: Get the source and target of link {linkId}.
        slots:
          linkId: path.linkId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{linkId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a resource link
      effect: write
      questions:
      - How do I link two Azure resources together?
      - Can I add notes to a link between resources?
      instructions:
      - text: Create resource link {linkId} with properties {properties}.
        slots:
          linkId: path.linkId
          properties: requestBody.properties
      - text: Update the existing link {linkId} between my resources.
        slots:
          linkId: path.linkId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{linkId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource link
      effect: destructive
      questions:
      - How do I remove a link between two Azure resources?
      - Does deleting a resource link affect the linked resources themselves?
      instructions:
      - text: Delete resource link {linkId}.
        slots:
          linkId: path.linkId
      - text: Remove the link {linkId} between my resources.
        slots:
          linkId: path.linkId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/links'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource links in a subscription
      effect: read
      questions:
      - Which resource links exist across my subscription?
      - Can I filter subscription resource links by target resource?
      instructions:
      - text: List all resource links in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show subscription {subscriptionId} links matching filter {filter}.
        slots:
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{scope}/providers/Microsoft.Resources/links'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource links at and below a scope
      effect: read
      questions:
      - How do I see resource links under a specific resource group or resource?
      - Can I list links at a source scope and everything beneath it?
      instructions:
      - text: List resource links at and below scope {scope}.
        slots:
          scope: path.scope
      - text: Show links under source scope {scope} filtered by {filter}.
        slots:
          scope: path.scope
          filter: query.$filter
      method: generated
      generated: '2026-10-01'