API Evangelist conversational phrasing for Microsoft Azure Application Data API

# 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 Application Data API
  version: 1.0.0
extends: openapi/microsoft-azure-applicationdata-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['/application-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List application data across all parties
      effect: read
      questions:
      - How do I list every fertilizer or chemical application record across all farm parties?
      - Can I filter application data by operation dates, area or material applied?
      instructions:
      - text: List application data across all parties started after {min_start}.
        slots:
          min_start: query.minOperationStartDateTime
      - text: List all parties' application records covering at least {min_area} in area.
        slots:
          min_area: query.minArea
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-data/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an application data cascade delete job
      effect: read
      questions:
      - How do I see whether a cascade delete of application data has finished?
      - What is the status of an application data deletion job?
      instructions:
      - text: Get the application data cascade delete job {job_id}.
        slots:
          job_id: path.jobId
      - text: Check progress of application data deletion job {job_id}.
        slots:
          job_id: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-data/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade delete an application data record
      effect: destructive
      questions:
      - How do I delete an application data record along with everything linked to it?
      - Can I run the application data deletion as a background job I can track?
      instructions:
      - text: Start cascade delete job {job_id} for application data {application_data_id} of party {party_id}.
        slots:
          job_id: path.jobId
          application_data_id: query.applicationDataId
          party_id: query.partyId
      - text: Remove application record {application_data_id} and its dependents for party {party_id} as job {job_id}.
        slots:
          application_data_id: query.applicationDataId
          party_id: query.partyId
          job_id: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/application-data'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's application data
      effect: read
      questions:
      - Which application data records belong to one particular farmer or party?
      - Can I list a single party's application records linked to a specific boundary?
      instructions:
      - text: List the application data for party {party_id}.
        slots:
          party_id: path.partyId
      - text: List party {party_id}'s application records linked to boundaries {boundary_ids}.
        slots:
          party_id: path.partyId
          boundary_ids: query.associatedBoundaryIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/application-data/{applicationDataId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one application data record
      effect: read
      questions:
      - How do I retrieve a single application data record for a party?
      - What product, area and material details are stored on one application record?
      instructions:
      - text: Get application data {application_data_id} for party {party_id}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
      - text: Show the details of application record {application_data_id} under party {party_id}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/application-data/{applicationDataId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one application data record
      effect: destructive
      questions:
      - How do I delete just one application data record without a cascade job?
      - Can I directly remove a single party's application record?
      instructions:
      - text: Delete application data {application_data_id} for party {party_id}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
      - text: Remove only the record {application_data_id} from party {party_id}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/application-data/{applicationDataId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update an application data record
      effect: write
      questions:
      - How do I record a new fertilizer or spray application for a party?
      - Can I update the area or total material on an existing application record?
      instructions:
      - text: Create application data {application_data_id} for party {party_id} with total material {total_material} over area {area}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
          total_material: requestBody.totalMaterial
          area: requestBody.area
      - text: Update application record {application_data_id} of party {party_id} to name {name}.
        slots:
          application_data_id: path.applicationDataId
          party_id: path.partyId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-data:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search application data by geometry
      effect: read
      questions:
      - How do I find application records whose area intersects a field shape I draw?
      - Can I search application data across all parties by geometry instead of by ID?
      instructions:
      - text: Search application data that intersects geometry {geometry}.
        slots:
          geometry: requestBody.intersectsWithGeometry
      - text: Find application records for party {party_id} intersecting shape {geometry}.
        slots:
          party_id: requestBody.partyId
          geometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'