# 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 Prescriptions API
  version: 1.0.0
extends: openapi/microsoft-azure-prescriptions-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}/prescriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's prescriptions
      effect: read
      questions:
      - Which prescriptions belong to a specific farmer or party in Azure Data Manager for Agriculture?
      - Can I filter a party's prescriptions by product name or status?
      instructions:
      - text: List prescriptions for party {party}.
        slots:
          party: path.partyId
      - text: Show party {party}'s prescriptions for product {product} with status {status}.
        slots:
          party: path.partyId
          product: query.productNames
          status: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescriptions/{prescriptionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a party's prescription
      effect: read
      questions:
      - What are the details of one prescription for a party?
      - Can I see a prescription's product and measurements?
      instructions:
      - text: Get prescription {prescription} for party {party}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
      - text: Show the product and measurements of prescription {prescription} under party {party}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescriptions/{prescriptionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a party's prescription
      effect: destructive
      questions:
      - Can I delete a single prescription under a party?
      - How do I remove one prescription without a cascade job?
      instructions:
      - text: Delete prescription {prescription} for party {party}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
      - text: Remove party {party}'s prescription {prescription}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescriptions/{prescriptionId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a prescription
      effect: write
      questions:
      - How do I record a new fertilizer or seed prescription for a party?
      - Can I change the product on an existing prescription?
      instructions:
      - text: Create prescription {prescription} for party {party} with product {product}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
          product: requestBody.productName
      - text: Update prescription {prescription} under party {party} to status {status}.
        slots:
          prescription: path.prescriptionId
          party: path.partyId
          status: requestBody.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List prescriptions across all parties
      effect: read
      questions:
      - Can I see every prescription across all parties at once?
      - Which prescriptions were created in a date range, regardless of party?
      instructions:
      - text: List prescriptions across all parties.
      - text: Show all parties' prescriptions created after {min}.
        slots:
          min: query.minCreatedDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescriptions/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a prescription cascade delete job
      effect: read
      questions:
      - Has my prescription cascade delete job finished?
      - How do I check on a cascade delete of a prescription?
      instructions:
      - text: Get prescription cascade delete job {job}.
        slots:
          job: path.jobId
      - text: Show the status of prescription deletion job {job}.
        slots:
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescriptions/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade delete a prescription
      effect: destructive
      questions:
      - How do I delete a prescription and everything that depends on it?
      - Can I run a cascade delete for one party's prescription as a job?
      instructions:
      - text: Start cascade delete job {job} for prescription {prescription} of party {party}.
        slots:
          job: path.jobId
          prescription: query.prescriptionId
          party: query.partyId
      - text: Cascade delete prescription {prescription} under party {party} as job {job}.
        slots:
          prescription: query.prescriptionId
          party: query.partyId
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescription:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search prescriptions by geometry
      effect: read
      questions:
      - Which prescriptions intersect a particular field boundary?
      - Can I search prescriptions by a GeoJSON area?
      instructions:
      - text: Search prescriptions intersecting geometry {geometry}.
        slots:
          geometry: requestBody.intersectsWithGeometry
      - text: Find party {party}'s prescriptions that overlap {geometry}.
        slots:
          party: requestBody.partyId
          geometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'