# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Method Entity Vehicles API
  version: 1.0.0
extends: openapi/methodfi-entity-vehicles-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/entities/{entityId}/vehicles'].get
  update:
    x-apievangelist-phrasing:
      intent: List vehicles for an entity
      effect: read
      questions:
      - Which vehicles are on file for this person?
      - Can I see every vehicle record for an entity?
      instructions:
      - text: List vehicles for entity {entity}.
        slots:
          entity: path.entityId
      - text: Show the vehicles on file for entity {entity}.
        slots:
          entity: path.entityId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/entities/{entityId}/vehicles'].post
  update:
    x-apievangelist-phrasing:
      intent: Search for an entity's vehicles
      effect: read
      questions:
      - How do I find vehicles associated with a person?
      - Can I run a fresh vehicle search for an entity?
      instructions:
      - text: Search for vehicles owned by entity {entity}.
        slots:
          entity: path.entityId
      - text: Run a new vehicle search on entity {entity}.
        slots:
          entity: path.entityId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/entities/{entityId}/vehicles/{vhlId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one vehicle record
      effect: read
      questions:
      - Can I look up a single vehicle record by its ID?
      - What details are stored for a specific vehicle?
      instructions:
      - text: Get vehicle {vehicle} for entity {entity}.
        slots:
          vehicle: path.vhlId
          entity: path.entityId
      - text: Show the details of vehicle {vehicle} on entity {entity}.
        slots:
          vehicle: path.vhlId
          entity: path.entityId
      method: generated
      generated: '2026-10-01'