# 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 Azure AgFoodPlatform Data Plane Service…
  version: 1.0.0
extends: openapi/microsoft-azure-boundaries-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: 10
- target: $.paths['/boundaries'].get
  update:
    x-apievangelist-phrasing:
      intent: List farm boundaries across all parties
      effect: read
      questions:
      - How do I list every field boundary in my Data Manager for Agriculture instance?
      - Can I filter boundaries by minimum and maximum area?
      instructions:
      - text: List all boundaries across every party.
      - text: List boundaries larger than {minArea} and smaller than {maxArea}.
        slots:
          minArea: query.minArea
          maxArea: query.maxArea
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boundaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Search boundaries by geometry across parties
      effect: read
      questions:
      - Which field boundaries across all parties intersect a given polygon?
      - Can I search every party's boundaries by name and status in one request?
      instructions:
      - text: Search all parties for boundaries intersecting geometry {intersectsWithGeometry}.
        slots:
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      - text: Find boundaries across all parties named {names}.
        slots:
          names: requestBody.names
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boundaries/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a boundary cascade delete job
      effect: read
      questions:
      - What is the status of my boundary cascade delete job?
      - Has the job that deletes a boundary and its dependents finished?
      instructions:
      - text: Get the status of boundary cascade delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Check whether cascade delete job {jobId} has completed.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boundaries/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete a boundary and its dependents
      effect: destructive
      questions:
      - How do I delete a field boundary along with everything that depends on it?
      - Can I remove a boundary for a party as a background job?
      instructions:
      - text: Start cascade delete job {jobId} for boundary {boundaryId} of party {partyId}.
        slots:
          jobId: path.jobId
          boundaryId: query.boundaryId
          partyId: query.partyId
      - text: Cascade-delete boundary {boundaryId} owned by party {partyId} as job {jobId}.
        slots:
          jobId: path.jobId
          boundaryId: query.boundaryId
          partyId: query.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries'].get
  update:
    x-apievangelist-phrasing:
      intent: List boundaries for one party
      effect: read
      questions:
      - Which field boundaries belong to a particular farmer or party?
      - Can I list one party's boundaries created after a certain date?
      instructions:
      - text: List the boundaries owned by party {partyId}.
        slots:
          partyId: path.partyId
      - text: List party {partyId} boundaries created after {minCreatedDateTime}.
        slots:
          partyId: path.partyId
          minCreatedDateTime: query.minCreatedDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Search one party's boundaries by geometry
      effect: read
      questions:
      - Which of a single party's boundaries overlap a shape I draw?
      - Can I search one party's boundaries by name or status?
      instructions:
      - text: Search party {partyId} for boundaries intersecting {intersectsWithGeometry}.
        slots:
          partyId: path.partyId
          intersectsWithGeometry: requestBody.intersectsWithGeometry
      - text: Find boundaries of party {partyId} with status {statuses}.
        slots:
          partyId: path.partyId
          statuses: requestBody.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries/{boundaryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a party's boundary
      effect: read
      questions:
      - What geometry and area does a specific field boundary have?
      - How do I fetch a single boundary for a party?
      instructions:
      - text: Show boundary {boundaryId} of party {partyId}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
      - text: Get the geometry of boundary {boundaryId} for party {partyId}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries/{boundaryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single boundary
      effect: destructive
      questions:
      - How do I delete just one boundary record for a party?
      - Can I remove a field boundary directly without a cascade job?
      instructions:
      - text: Delete boundary {boundaryId} of party {partyId}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
      - text: Remove the single boundary record {boundaryId} for party {partyId}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries/{boundaryId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a field boundary
      effect: write
      questions:
      - How do I save a new field boundary polygon for a party?
      - Can I rename a boundary or change its geometry?
      instructions:
      - text: Create boundary {boundaryId} for party {partyId} with geometry {geometry}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
          geometry: requestBody.geometry
      - text: Rename boundary {boundaryId} of party {partyId} to {name}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/boundaries/{boundaryId}/overlap'].get
  update:
    x-apievangelist-phrasing:
      intent: Measure overlap between two boundaries
      effect: read
      questions:
      - How much area do two field boundaries share?
      - Can I compare boundaries that belong to different parties for overlap?
      instructions:
      - text: Calculate the overlap between boundary {boundaryId} of party {partyId} and boundary {otherBoundaryId} of party {otherPartyId}.
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
          otherBoundaryId: query.otherBoundaryId
          otherPartyId: query.otherPartyId
      - text: Get the shared area of boundaries {boundaryId} and {otherBoundaryId} (parties {partyId} and {otherPartyId}).
        slots:
          partyId: path.partyId
          boundaryId: path.boundaryId
          otherBoundaryId: query.otherBoundaryId
          otherPartyId: query.otherPartyId
      method: generated
      generated: '2026-09-26'