# 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 Weather Data API
  version: 1.0.0
extends: openapi/microsoft-azure-weather-data-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: 2
- target: $.paths['/weather-data/:fetch'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch weather data using a provider API key
      effect: read
      questions:
      - How do I pull weather forecasts for farm locations by passing my weather provider API key directly?
      - Can I choose metric or imperial units when fetching weather with a provider key and app ID?
      instructions:
      - text: Fetch weather via extension {extensionId} API {extensionApiName} using provider key {providerApiKey} in {units} units.
        slots:
          extensionId: requestBody.extensionId
          extensionApiName: requestBody.extensionApiName
          providerApiKey: requestBody.providerApiKey
          units: requestBody.units
      - text: Get weather for {locations} with provider app {providerAppId} and key {providerApiKey}.
        slots:
          locations: requestBody.locations
          providerAppId: requestBody.providerAppId
          providerApiKey: requestBody.providerApiKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/weather-data:fetch'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch weather data using a credentials object
      effect: read
      questions:
      - How do I fetch weather data for my locations by supplying a credentials object instead of a raw key?
      - Can I limit a credentials-based weather fetch to a window of hours from now?
      instructions:
      - text: Fetch weather via extension {extensionId} API {extensionApiName} in {units} units with credentials {credentials}.
        slots:
          extensionId: requestBody.extensionId
          extensionApiName: requestBody.extensionApiName
          units: requestBody.units
          credentials: requestBody.credentials
      - text: Using stored credentials, get weather for {locations} from hour {startTimeHours} to {endTimeHours}.
        slots:
          locations: requestBody.locations
          startTimeHours: requestBody.startTimeHours
          endTimeHours: requestBody.endTimeHours
      method: generated
      generated: '2026-10-01'