# 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 Azure Digital Twins Event Routes API
  version: 1.0.0
extends: openapi/microsoft-azure-eventroutes-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['/eventroutes'].get
  update:
    x-apievangelist-phrasing:
      intent: List Digital Twins event routes
      effect: read
      questions:
      - Which event routes are configured in my Azure Digital Twins instance?
      - Can I limit how many event routes come back per page?
      instructions:
      - text: List all event routes in my Digital Twins instance.
      - text: List event routes, {maxItemsPerPage} per page.
        slots:
          maxItemsPerPage: header.max-items-per-page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventroutes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Digital Twins event route
      effect: read
      questions:
      - What endpoint and filter does a specific event route use?
      - What happens if I request an event route that doesn't exist?
      instructions:
      - text: Get event route {id}.
        slots:
          id: path.id
      - text: Show the endpoint and filter of Digital Twins event route {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventroutes/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace a Digital Twins event route
      effect: write
      questions:
      - How do I send Digital Twins events to an endpoint with an event route?
      - Can I filter which twin events an event route forwards?
      instructions:
      - text: Create event route {id} sending events to endpoint {endpointName} with filter {filter}.
        slots:
          id: path.id
          endpointName: requestBody.endpointName
          filter: requestBody.filter
      - text: Replace event route {id} so it forwards to {endpointName}.
        slots:
          id: path.id
          endpointName: requestBody.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/eventroutes/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Digital Twins event route
      effect: destructive
      questions:
      - How do I stop forwarding events by deleting an event route?
      - Can I remove a Digital Twins event route by its ID?
      instructions:
      - text: Delete event route {id}.
        slots:
          id: path.id
      - text: Remove Digital Twins event route {id} so it no longer forwards events.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'