# 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 Management Zones API
  version: 1.0.0
extends: openapi/microsoft-azure-managementzones-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: 7
- target: $.paths['/management-zones'].get
  update:
    x-apievangelist-phrasing:
      intent: List management zones across all parties
      effect: read
      questions:
      - How do I see management zones for every party in my farm data?
      - Can I list all management zones tied to a particular crop or season?
      instructions:
      - text: List management zones across all parties.
      - text: Show all management zones for crop {cropIds} in season {seasonIds}.
        slots:
          cropIds: query.cropIds
          seasonIds: query.seasonIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/management-zones/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a management zone cascade delete job
      effect: read
      questions:
      - Has my management zone cascade delete job completed?
      - Where can I check the status of a management zone deletion job?
      instructions:
      - text: Get management zone cascade delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Check on management zone deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/management-zones/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade delete a management zone
      effect: destructive
      questions:
      - How do I delete a management zone and everything linked to it?
      - Can I run a management zone removal as a background job?
      instructions:
      - text: Start cascade delete job {jobId} for management zone {managementZoneId} of party {partyId}.
        slots:
          jobId: path.jobId
          managementZoneId: query.managementZoneId
          partyId: query.partyId
      - text: Cascade delete zone {managementZoneId} under party {partyId} as job {jobId}.
        slots:
          managementZoneId: query.managementZoneId
          partyId: query.partyId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/management-zones'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's management zones
      effect: read
      questions:
      - Which management zones belong to a single party?
      - Can I filter a party's management zones by field?
      instructions:
      - text: List management zones for party {partyId}.
        slots:
          partyId: path.partyId
      - text: Show party {partyId}'s management zones on field {fieldIds}.
        slots:
          partyId: path.partyId
          fieldIds: query.fieldIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/management-zones/{managementZoneId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a management zone
      effect: read
      questions:
      - What crop, season and field is a given management zone attached to?
      - Can I fetch one management zone by id for a party?
      instructions:
      - text: Get management zone {managementZoneId} for party {partyId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
      - text: Show the details of zone {managementZoneId} under party {partyId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/management-zones/{managementZoneId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a management zone
      effect: destructive
      questions:
      - How do I delete a single management zone from a party?
      - Can I remove a management zone directly without a cascade job?
      instructions:
      - text: Delete management zone {managementZoneId} for party {partyId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
      - text: Remove zone {managementZoneId} from party {partyId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/management-zones/{managementZoneId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a management zone
      effect: write
      questions:
      - How do I define a management zone for a field and season?
      - Can I change the type or crop of an existing management zone?
      instructions:
      - text: Create management zone {managementZoneId} for party {partyId} on field {fieldId} for season {seasonId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
          fieldId: requestBody.fieldId
          seasonId: requestBody.seasonId
      - text: Update management zone {managementZoneId} of party {partyId} to type {type} and crop {cropId}.
        slots:
          partyId: path.partyId
          managementZoneId: path.managementZoneId
          type: requestBody.type
          cropId: requestBody.cropId
      method: generated
      generated: '2026-09-26'