# 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 Planting Data API
  version: 1.0.0
extends: openapi/microsoft-azure-plantingdata-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: 8
- target: $.paths['/parties/{partyId}/planting-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's planting data
      effect: read
      questions:
      - How do I get all the planting records for one farmer or party?
      - Can I filter a party's planting data by average planting rate or area?
      - Which planting operations for a party started within a date range?
      instructions:
      - text: List planting data for party {partyId}.
        slots:
          partyId: path.partyId
      - text: Show planting data for party {partyId} with planting rate between {minAvgPlantingRate} and {maxAvgPlantingRate}.
        slots:
          partyId: path.partyId
          minAvgPlantingRate: query.minAvgPlantingRate
          maxAvgPlantingRate: query.maxAvgPlantingRate
      - text: List party {partyId}'s planting operations that started after {minOperationStartDateTime}.
        slots:
          partyId: path.partyId
          minOperationStartDateTime: query.minOperationStartDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/planting-data/{plantingDataId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a planting data record
      effect: read
      questions:
      - Can I pull up one specific planting data record for a party?
      - What products and area are recorded on a given planting operation?
      instructions:
      - text: Get planting data {plantingDataId} for party {partyId}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
      - text: Show the details of planting record {plantingDataId} under party {partyId}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/planting-data/{plantingDataId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a planting data record
      effect: destructive
      questions:
      - How do I delete one planting data record from a party?
      - Can I remove a single incorrectly recorded planting operation?
      instructions:
      - text: Delete planting data {plantingDataId} for party {partyId}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
      - text: Remove planting record {plantingDataId} from party {partyId}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/planting-data/{plantingDataId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a planting data record
      effect: write
      questions:
      - How do I record a planting operation for a field?
      - Can I update the average planting rate or total material on an existing record?
      instructions:
      - text: Create planting data {plantingDataId} for party {partyId} with average planting rate {avgPlantingRate}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
          avgPlantingRate: requestBody.avgPlantingRate
      - text: Update planting data {plantingDataId} for party {partyId} to total material {totalMaterial} over area {area}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
          totalMaterial: requestBody.totalMaterial
          area: requestBody.area
      - text: Link planting record {plantingDataId} of party {partyId} to boundary {associatedBoundaryId}.
        slots:
          partyId: path.partyId
          plantingDataId: path.plantingDataId
          associatedBoundaryId: requestBody.associatedBoundaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/planting-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List planting data across all parties
      effect: read
      questions:
      - Is there a way to list planting data for every party at once?
      - Which planting records across all farms were modified recently?
      instructions:
      - text: List planting data across all parties.
      - text: Show all parties' planting data last modified after {minLastModifiedDateTime}.
        slots:
          minLastModifiedDateTime: query.minLastModifiedDateTime
      - text: List planting data from every party with status {statuses}.
        slots:
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/planting-data/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a planting data cascade delete job
      effect: read
      questions:
      - How do I check whether a planting data cascade delete has finished?
      - What's the status of a cascade delete job for planting data?
      instructions:
      - text: Get planting data cascade delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Check progress of the planting data deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/planting-data/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade delete a planting data record
      effect: destructive
      questions:
      - How do I delete a planting data record along with everything that depends on it?
      - Can I run the removal of planting data as a background job?
      instructions:
      - text: Start cascade delete job {jobId} for planting data {plantingDataId} of party {partyId}.
        slots:
          jobId: path.jobId
          plantingDataId: query.plantingDataId
          partyId: query.partyId
      - text: Cascade delete planting record {plantingDataId} under party {partyId} as job {jobId}.
        slots:
          plantingDataId: query.plantingDataId
          partyId: query.partyId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/planting-data:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search planting data by geometry
      effect: read
      questions:
      - How do I find planting data that falls inside a field shape I draw?
      - Can I search planting records by intersecting geometry across all parties?
      instructions:
      - text: Search planting data intersecting geometry {intersectsWithGeometry}.
        slots:
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      - text: Find planting data for party {partyId} that intersects {intersectsWithGeometry}.
        slots:
          partyId: requestBody.partyId
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'