# 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 Farms API
  version: 1.0.0
extends: openapi/microsoft-azure-farms-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['/farms'].get
  update:
    x-apievangelist-phrasing:
      intent: List farms across all parties
      effect: read
      questions:
      - Can I see every farm in my agriculture data workspace regardless of which grower owns it?
      - How do I filter farms by name, status or last modified date?
      instructions:
      - text: List all farms across every party.
      - text: List farms named {names} with status {statuses}.
        slots:
          names: query.names
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/farms/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a farm cascade delete job
      effect: read
      questions:
      - How do I check whether a farm cascade delete job has finished?
      - What status does a farm deletion job report?
      instructions:
      - text: Get farm cascade delete job {jobId}.
        slots:
          jobId: path.jobId
      - text: Check the progress of farm deletion job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/farms/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete a farm and its related data
      effect: destructive
      questions:
      - How do I delete a farm together with everything nested under it?
      - Can I remove a farm and its dependent resources in one background job?
      instructions:
      - text: Start cascade delete job {jobId} for farm {farmId} of party {partyId}.
        slots:
          jobId: path.jobId
          farmId: query.farmId
          partyId: query.partyId
      - text: Cascade-delete farm {farmId} belonging to {partyId} as job {jobId}.
        slots:
          farmId: query.farmId
          partyId: query.partyId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/farms'].get
  update:
    x-apievangelist-phrasing:
      intent: List a party's farms
      effect: read
      questions:
      - Which farms belong to a particular grower or party?
      - Can I filter one party's farms by creation date?
      instructions:
      - text: List the farms for party {partyId}.
        slots:
          partyId: path.partyId
      - text: Show farms of party {partyId} created after {minCreatedDateTime}.
        slots:
          partyId: path.partyId
          minCreatedDateTime: query.minCreatedDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/farms/{farmId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a party's farm
      effect: read
      questions:
      - How do I fetch the details of a single farm owned by a party?
      - What properties does one farm record hold?
      instructions:
      - text: Get farm {farmId} of party {partyId}.
        slots:
          farmId: path.farmId
          partyId: path.partyId
      - text: Show the details of party {partyId}'s farm {farmId}.
        slots:
          partyId: path.partyId
          farmId: path.farmId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/farms/{farmId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a party's farm
      effect: destructive
      questions:
      - Can I delete just the farm record for a party without a cascade job?
      - How do I remove a single farm from a grower?
      instructions:
      - text: Delete farm {farmId} of party {partyId}.
        slots:
          farmId: path.farmId
          partyId: path.partyId
      - text: Remove the farm record {farmId} from party {partyId}.
        slots:
          farmId: path.farmId
          partyId: path.partyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/parties/{partyId}/farms/{farmId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a party's farm
      effect: write
      questions:
      - How do I add a new farm for a grower?
      - Can I rename a farm or change its description and status?
      instructions:
      - text: Create farm {farmId} named {name} for party {partyId}.
        slots:
          farmId: path.farmId
          name: requestBody.name
          partyId: path.partyId
      - text: Update farm {farmId} of party {partyId} with description {description}.
        slots:
          farmId: path.farmId
          partyId: path.partyId
          description: requestBody.description
      method: generated
      generated: '2026-09-26'