# 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 Microsoft.VoiceServices.Provisioning Teams…
  version: 1.0.0
extends: openapi/microsoft-azure-teamsrequestforinformation-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['/teamsRequestsForInformation'].get
  update:
    x-apievangelist-phrasing:
      intent: List Teams requests for information
      effect: read
      questions:
      - Which Teams requests for information have been filed?
      - Can I filter and count the requests for information I get back?
      instructions:
      - text: List Teams requests for information.
      - text: List the top {top} requests for information matching {filter}.
        slots:
          top: query.top
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teamsRequestsForInformation/{tenantId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant's request for information
      effect: read
      questions:
      - What are the details of the request for information for one tenant?
      - Can I fetch a request for information only if it changed since a date?
      instructions:
      - text: Get the request for information for tenant {tenant}.
        slots:
          tenant: path.tenantId
      - text: Get tenant {tenant}'s request for information if modified since {since}.
        slots:
          tenant: path.tenantId
          since: header.If-Modified-Since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teamsRequestsForInformation/{tenantId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a tenant's request for information
      effect: write
      questions:
      - Can I create or update a Teams request for information for a tenant?
      - Is it possible to record the customer relationship on a request for information?
      instructions:
      - text: Create or update the request for information for tenant {tenant}.
        slots:
          tenant: path.tenantId
      - text: Set customer relationship {relationship} on tenant {tenant}'s request for information.
        slots:
          relationship: requestBody.customerRelationship
          tenant: path.tenantId
      method: generated
      generated: '2026-09-26'