# 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 Tillage Data API
  version: 1.0.0
extends: openapi/microsoft-azure-tillagedata-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}/tillage-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List tillage records for a party
      effect: read
      questions:
      - What tillage operations have been recorded for one farmer or party?
      - Can I filter a party's tillage data by tillage depth or date?
      instructions:
      - text: List tillage data for party {party}.
        slots:
          party: path.partyId
      - text: Show tillage records for party {party} deeper than {depth}.
        slots:
          party: path.partyId
          depth: query.minTillageDepth
      - text: List party {party} tillage operations that started after {start}.
        slots:
          party: path.partyId
          start: query.minOperationStartDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/tillage-data/{tillageDataId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tillage data record
      effect: read
      questions:
      - What were the depth and pressure of one recorded tillage operation?
      - Can I fetch a single tillage record for a party by its ID?
      instructions:
      - text: Show tillage record {tillage} for party {party}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
      - text: Get tillage depth and pressure for record {tillage} under party {party}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/tillage-data/{tillageDataId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tillage data record
      effect: destructive
      questions:
      - How do I delete one tillage record that was logged by mistake?
      - Can I remove a party's individual tillage entry?
      instructions:
      - text: Delete tillage record {tillage} for party {party}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
      - text: Remove the tillage entry {tillage} from party {party}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/tillage-data/{tillageDataId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a tillage data record
      effect: write
      questions:
      - How do I record a tillage operation with its depth and pressure?
      - Can I link a tillage record to a field boundary?
      instructions:
      - text: Record tillage {tillage} for party {party} at depth {depth}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
          depth: requestBody.tillageDepth
      - text: Set tillage pressure {pressure} on record {tillage} for party {party}.
        slots:
          pressure: requestBody.tillagePressure
          tillage: path.tillageDataId
          party: path.partyId
      - text: Attach tillage record {tillage} of party {party} to boundary {boundary}.
        slots:
          tillage: path.tillageDataId
          party: path.partyId
          boundary: requestBody.associatedBoundaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tillage-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List tillage records across all parties
      effect: read
      questions:
      - Which tillage operations have been logged across every farm party?
      - Can I filter all tillage data by source or status?
      instructions:
      - text: List tillage data across all parties.
      - text: Show tillage records from all parties with source {sources}.
        slots:
          sources: query.sources
      - text: List every party's tillage covering at least {area} area.
        slots:
          area: query.minArea
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tillage-data/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a tillage cascade delete job
      effect: read
      questions:
      - Has my cascade delete of tillage data finished?
      - What is the status of a tillage cascade delete job?
      instructions:
      - text: Show tillage cascade delete job {job}.
        slots:
          job: path.jobId
      - text: Check progress of tillage deletion job {job}.
        slots:
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tillage-data/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete a tillage record and its dependents
      effect: destructive
      questions:
      - How do I delete a tillage record together with everything that depends on it?
      - Can I run tillage deletion as a background job I can track?
      instructions:
      - text: Start cascade delete job {job} for tillage record {tillage} of party {party}.
        slots:
          job: path.jobId
          tillage: query.tillageDataId
          party: query.partyId
      - text: Cascade-delete tillage {tillage} under party {party} as job {job}.
        slots:
          tillage: query.tillageDataId
          party: query.partyId
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tillage-data:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search tillage data by geometry
      effect: read
      questions:
      - Can I find tillage operations that intersect a field shape I draw?
      - Which tillage records overlap a given geometry across all parties?
      instructions:
      - text: Search tillage data intersecting geometry {geometry}.
        slots:
          geometry: requestBody.intersectsWithGeometry
      - text: Find tillage for party {party} overlapping {geometry}.
        slots:
          party: requestBody.partyId
          geometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'