# 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 Plant Tissue Analyses API
  version: 1.0.0
extends: openapi/microsoft-azure-planttissueanalyses-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}/plant-tissue-analyses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's plant tissue analyses
      effect: read
      questions:
      - Which plant tissue analyses belong to one grower or party?
      - Can I narrow a party's plant tissue analyses to a single field or season?
      instructions:
      - text: List plant tissue analyses for party {party}.
        slots:
          party: path.partyId
      - text: List party {party}'s plant tissue analyses for field {field} in season {season}.
        slots:
          party: path.partyId
          field: query.fieldIds
          season: query.seasonIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/plant-tissue-analyses/{plantTissueAnalysisId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a party's plant tissue analysis
      effect: read
      questions:
      - What are the results of a specific plant tissue analysis for a party?
      - Can I retrieve one plant tissue analysis record by its ID?
      instructions:
      - text: Get plant tissue analysis {analysis} for party {party}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
      - text: Show lab details of plant tissue analysis {analysis} under party {party}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/plant-tissue-analyses/{plantTissueAnalysisId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a plant tissue analysis
      effect: destructive
      questions:
      - Can I delete a single plant tissue analysis for a party?
      - Is removing one plant tissue analysis different from a cascade delete?
      instructions:
      - text: Delete plant tissue analysis {analysis} for party {party}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
      - text: Remove only the analysis record {analysis} from party {party}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/plant-tissue-analyses/{plantTissueAnalysisId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a plant tissue analysis
      effect: write
      questions:
      - Can I record a new plant tissue analysis with its growth stage and plant part?
      - What fields can I set when logging a plant tissue sample for a field and crop?
      instructions:
      - text: Create plant tissue analysis {analysis} for party {party} on field {field}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
          field: requestBody.fieldId
      - text: Update plant tissue analysis {analysis} for party {party} with growth stage {growthStage} and plant part {plantPart}.
        slots:
          analysis: path.plantTissueAnalysisId
          party: path.partyId
          growthStage: requestBody.growthStage
          plantPart: requestBody.plantPart
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plant-tissue-analyses'].get
  update:
    x-apievangelist-phrasing:
      intent: List plant tissue analyses across all parties
      effect: read
      questions:
      - Can I list plant tissue analyses across every party at once?
      - Which plant tissue analyses were created within a given date range?
      instructions:
      - text: List plant tissue analyses across all parties.
      - text: List all parties' plant tissue analyses created after {minCreated} for crop {crop}.
        slots:
          minCreated: query.minCreatedDateTime
          crop: query.cropIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plant-tissue-analyses/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a plant tissue analysis cascade delete job
      effect: read
      questions:
      - What is the status of my plant tissue analysis cascade delete job?
      - Has the cascade delete for a plant tissue analysis finished?
      instructions:
      - text: Get cascade delete job {job} for plant tissue analyses.
        slots:
          job: path.jobId
      - text: Check progress of plant tissue cascade delete job {job}.
        slots:
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plant-tissue-analyses/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a cascade delete of a plant tissue analysis
      effect: destructive
      questions:
      - Can I delete a plant tissue analysis along with everything that depends on it?
      - What does a cascade delete job for a plant tissue analysis need?
      instructions:
      - text: Start cascade delete job {job} for plant tissue analysis {analysis} of party {party}.
        slots:
          job: path.jobId
          analysis: query.plantTissueAnalysisId
          party: query.partyId
      - text: Cascade delete plant tissue analysis {analysis} for party {party} as job {job}.
        slots:
          analysis: query.plantTissueAnalysisId
          party: query.partyId
          job: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plant-tissue-analyses:search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search plant tissue analyses by geometry
      effect: read
      questions:
      - Can I find plant tissue analyses whose samples intersect a map area?
      - Which plant tissue analyses fall inside a given field boundary geometry?
      instructions:
      - text: Search plant tissue analyses that intersect geometry {geometry}.
        slots:
          geometry: requestBody.intersectsWithGeometry
      - text: Find party {party}'s plant tissue analyses intersecting {geometry}.
        slots:
          party: requestBody.partyId
          geometry: requestBody.intersectsWithGeometry
      method: generated
      generated: '2026-09-26'