# 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 Prescription Maps API
  version: 1.0.0
extends: openapi/microsoft-azure-prescriptionmaps-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: 7
- target: $.paths['/parties/{partyId}/prescription-maps'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's prescription maps
      effect: read
      questions:
      - Which prescription maps belong to one grower or party in Azure Data Manager for Agriculture?
      - Can I filter a party's prescription maps by field, crop or season?
      instructions:
      - text: List prescription maps for party {partyId}.
        slots:
          partyId: path.partyId
      - text: List party {partyId}'s prescription maps for fields {fieldIds} in seasons {seasonIds}.
        slots:
          partyId: path.partyId
          fieldIds: query.fieldIds
          seasonIds: query.seasonIds
      - text: Show party {partyId}'s prescription maps with status {statuses}.
        slots:
          partyId: path.partyId
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescription-maps/{prescriptionMapId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a prescription map
      effect: read
      questions:
      - How do I look up one prescription map for a party?
      - What crop, field and season is a specific prescription map tied to?
      instructions:
      - text: Get prescription map {prescriptionMapId} for party {partyId}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
      - text: Show the details of prescription map {prescriptionMapId} under {partyId}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescription-maps/{prescriptionMapId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a prescription map
      effect: destructive
      questions:
      - How do I delete a single prescription map for a party?
      - Can I remove one prescription map without starting a cascade delete job?
      instructions:
      - text: Delete prescription map {prescriptionMapId} for party {partyId}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
      - text: Remove prescription map {prescriptionMapId} directly from {partyId}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/prescription-maps/{prescriptionMapId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a prescription map
      effect: write
      questions:
      - How do I save a new variable-rate prescription map for a field?
      - Can I link a prescription map to a crop, season and field when I create it?
      instructions:
      - text: Create prescription map {prescriptionMapId} for party {partyId} on field {fieldId} and crop {cropId}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
          fieldId: requestBody.fieldId
          cropId: requestBody.cropId
      - text: Rename prescription map {prescriptionMapId} under {partyId} to {name}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
          name: requestBody.name
      - text: Set the status of prescription map {prescriptionMapId} for {partyId} to {status}.
        slots:
          prescriptionMapId: path.prescriptionMapId
          partyId: path.partyId
          status: requestBody.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescription-maps'].get
  update:
    x-apievangelist-phrasing:
      intent: List prescription maps across all parties
      effect: read
      questions:
      - What prescription maps exist across every party in my farm data?
      - Can I search all prescription maps by type or creation date range?
      instructions:
      - text: List prescription maps across all parties.
      - text: List all parties' prescription maps of type {types} created after {minCreatedDateTime}.
        slots:
          types: query.types
          minCreatedDateTime: query.minCreatedDateTime
      - text: Find prescription maps for crops {cropIds} across every party.
        slots:
          cropIds: query.cropIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescription-maps/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a prescription map cascade delete job
      effect: read
      questions:
      - Has my prescription map cascade delete job finished?
      - How can I check the status of a cascade delete for a prescription map?
      instructions:
      - text: Get cascade delete job {jobId} for prescription maps.
        slots:
          jobId: path.jobId
      - text: Check progress of prescription map deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/prescription-maps/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a cascade delete of a prescription map
      effect: destructive
      questions:
      - How do I delete a prescription map together with everything that depends on it?
      - Can I run a background job to cascade-delete a party's prescription map?
      instructions:
      - text: Start cascade delete job {jobId} for prescription map {prescriptionMapId} of party {partyId}.
        slots:
          jobId: path.jobId
          prescriptionMapId: query.prescriptionMapId
          partyId: query.partyId
      - text: Cascade-delete prescription map {prescriptionMapId} under {partyId} as job {jobId}.
        slots:
          prescriptionMapId: query.prescriptionMapId
          partyId: query.partyId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'