# 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 Turn API
  version: 1.0.0
extends: openapi/microsoft-azure-turn-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: 2
- target: $.paths['/networktraversal/:issueRelayConfiguration'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue TURN relay credentials for an existing identity
      effect: write
      questions:
      - How do I get STUN/TURN relay credentials for a Communication Services user I already created?
      - Can relay configuration be issued tied to an existing communication identity?
      instructions:
      - text: Issue a TURN relay configuration for identity {id} using the lowercase networktraversal route.
        slots:
          id: requestBody.id
      - text: Get STUN and TURN server credentials for existing communication user {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/networkTraversal/:issueRelayConfiguration'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a STUN/TURN relay configuration
      effect: write
      questions:
      - How do I obtain TURN server credentials for a media call in Azure Communication Services?
      - Can I choose between any route and nearest route for the relay?
      - How long are issued relay credentials valid, and can I set the lifetime?
      instructions:
      - text: Issue a relay configuration with route type {routeType}.
        slots:
          routeType: requestBody.routeType
      - text: Get relay server credentials valid for {ttl} seconds.
        slots:
          ttl: requestBody.ttl
      method: generated
      generated: '2026-09-26'