# 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 Seasonal Fields API
  version: 1.0.0
extends: openapi/microsoft-azure-seasonalfields-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}/seasonal-fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's seasonal fields
      effect: read
      questions:
      - Which seasonal fields does one grower or party have in Azure Data Manager for Agriculture?
      - Can I filter a party's seasonal fields by season or crop?
      - How do I find a farmer's seasonal fields modified after a certain date?
      instructions:
      - text: List seasonal fields for party {partyId}.
        slots:
          partyId: path.partyId
      - text: List party {partyId}'s seasonal fields for season {seasonIds} and crop {cropIds}.
        slots:
          partyId: path.partyId
          seasonIds: query.seasonIds
          cropIds: query.cropIds
      - text: Show seasonal fields under party {partyId} changed since {minLastModifiedDateTime}.
        slots:
          partyId: path.partyId
          minLastModifiedDateTime: query.minLastModifiedDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/seasonal-fields/{seasonalFieldId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a seasonal field
      effect: read
      questions:
      - How do I look up one seasonal field record for a party?
      - What crop and season is a specific seasonal field linked to?
      instructions:
      - text: Get seasonal field {seasonalFieldId} for party {partyId}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
      - text: Show which farm, field and season seasonal field {seasonalFieldId} of party {partyId} belongs to.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/seasonal-fields/{seasonalFieldId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a seasonal field
      effect: destructive
      questions:
      - How do I delete just one seasonal field record without a cascade job?
      - Can I remove a party's seasonal field directly?
      instructions:
      - text: Delete seasonal field {seasonalFieldId} of party {partyId}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
      - text: Remove the seasonal-field record {seasonalFieldId} under party {partyId}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/seasonal-fields/{seasonalFieldId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a seasonal field
      effect: write
      questions:
      - How do I record which crop is planted on a field for a given season?
      - Can I update the status or name of an existing seasonal field?
      instructions:
      - text: Create seasonal field {seasonalFieldId} for party {partyId} on field {fieldId} in season {seasonId}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
          fieldId: requestBody.fieldId
          seasonId: requestBody.seasonId
      - text: Set the crop of seasonal field {seasonalFieldId} under party {partyId} to {cropId}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
          cropId: requestBody.cropId
      - text: Rename seasonal field {seasonalFieldId} of party {partyId} to {name}.
        slots:
          seasonalFieldId: path.seasonalFieldId
          partyId: path.partyId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seasonal-fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List seasonal fields across all parties
      effect: read
      questions:
      - Can I list seasonal fields for every party at once?
      - Which seasonal fields across all growers are planted with a certain crop?
      instructions:
      - text: List seasonal fields across all parties.
      - text: List all-party seasonal fields for crop {cropIds}, {maxPageSize} per page.
        slots:
          cropIds: query.cropIds
          maxPageSize: query.maxPageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seasonal-fields/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a seasonal field cascade-delete job
      effect: read
      questions:
      - Has my cascade delete of a seasonal field finished?
      - How do I check the status of a seasonal field deletion job?
      instructions:
      - text: Get cascade delete job {jobId} for seasonal fields.
        slots:
          jobId: path.jobId
      - text: Check the progress of seasonal field deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seasonal-fields/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade-delete a seasonal field and its data
      effect: destructive
      questions:
      - How do I delete a seasonal field along with everything that depends on it?
      - Is there a background job for removing a seasonal field and its child resources?
      instructions:
      - text: Start cascade delete job {jobId} for seasonal field {seasonalFieldId} of party {partyId}.
        slots:
          jobId: path.jobId
          seasonalFieldId: query.seasonalFieldId
          partyId: query.partyId
      - text: Cascade-remove seasonal field {seasonalFieldId} under party {partyId} and all its dependent data.
        slots:
          seasonalFieldId: query.seasonalFieldId
          partyId: query.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seasonal-fields:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search seasonal fields by geometry
      effect: read
      questions:
      - Which seasonal fields intersect a particular area on the map?
      - Can I search seasonal fields by a GeoJSON boundary and crop together?
      instructions:
      - text: Search seasonal fields intersecting geometry {intersectsWithGeometry}.
        slots:
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      - text: Find seasonal fields of party {partyId} that overlap area {intersectsWithGeometry}.
        slots:
          partyId: requestBody.partyId
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'