# 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 Fields API
  version: 1.0.0
extends: openapi/microsoft-azure-fields-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['/fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List farm fields across all parties
      effect: read
      questions:
      - How do I list every farm field across all growers in Data Manager for Agriculture?
      - Can I filter fields by farm or by last-modified date across all parties?
      instructions:
      - text: List all fields across every party.
      - text: List fields on farms {farmIds} across all parties.
        slots:
          farmIds: query.farmIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fields/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a field cascade delete job
      effect: read
      questions:
      - Has the cascade delete of my field and its data finished?
      - What's the status of a field deletion job?
      instructions:
      - text: Check field cascade delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Show progress of field deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fields/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete a field and all its dependent data
      effect: destructive
      questions:
      - How do I delete a field along with everything underneath it?
      - Is there a job-based way to cascade delete a field?
      instructions:
      - text: Start cascade delete job {jobId} for field {fieldId} of party {partyId}.
        slots:
          jobId: path.jobId
          fieldId: query.fieldId
          partyId: query.partyId
      - text: Cascade delete field {fieldId} owned by {partyId} as job {jobId}.
        slots:
          fieldId: query.fieldId
          partyId: query.partyId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's farm fields
      effect: read
      questions:
      - Which fields belong to a particular grower or party?
      - Can I page through one party's fields by status?
      instructions:
      - text: List fields for party {partyId}.
        slots:
          partyId: path.partyId
      - text: Show party {partyId}'s fields with status {statuses}.
        slots:
          partyId: path.partyId
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/fields/{fieldId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one farm field
      effect: read
      questions:
      - How do I look up a specific field for a grower?
      - What details are stored on a single field record?
      instructions:
      - text: Get field {fieldId} of party {partyId}.
        slots:
          fieldId: path.fieldId
          partyId: path.partyId
      - text: Show details of field {fieldId} under {partyId}.
        slots:
          fieldId: path.fieldId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/fields/{fieldId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single farm field record
      effect: destructive
      questions:
      - How do I delete just the field record for a party?
      - Can I remove one field directly without starting a job?
      instructions:
      - text: Delete field {fieldId} of party {partyId}.
        slots:
          fieldId: path.fieldId
          partyId: path.partyId
      - text: Remove the field record {fieldId} under {partyId} directly.
        slots:
          fieldId: path.fieldId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/fields/{fieldId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a farm field
      effect: write
      questions:
      - How do I add a new field to a grower's farm?
      - Can I rename a field or attach it to a different farm?
      instructions:
      - text: Create field {fieldId} named {name} for party {partyId} on farm {farmId}.
        slots:
          fieldId: path.fieldId
          name: requestBody.name
          partyId: path.partyId
          farmId: requestBody.farmId
      - text: Rename field {fieldId} of party {partyId} to {name}.
        slots:
          fieldId: path.fieldId
          partyId: path.partyId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/fields:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search fields by geometry and filters
      effect: read
      questions:
      - Which fields intersect a given area on the map?
      - Can I search fields by name and status across all parties?
      instructions:
      - text: Search fields named {names} across all parties.
        slots:
          names: requestBody.names
      - text: Find fields on farms {farmIds} that intersect this geometry.
        slots:
          farmIds: requestBody.farmIds
      method: generated
      generated: '2026-09-26'