# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elation Health Print Headers API
  version: 1.0.0
extends: openapi/elation-health-print-headers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/print_headers/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a practice's print headers (legacy)
      effect: read
      questions:
      - How do I see the letterhead print headers set up for my practice on the legacy endpoint?
      - Can the old print header finder filter by practice?
      instructions:
      - text: Find legacy print headers for practice {practice}.
        slots:
          practice: query.practice
      - text: Show every old-style print header.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/print_headers/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a print header (legacy)
      effect: read
      questions:
      - Can I fetch one print header from the legacy unversioned path?
      - Which legacy call shows a single document header's contents?
      instructions:
      - text: Fetch legacy print header {id}.
        slots:
          id: path.id
      - text: Show a single print header from the legacy endpoint.
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/print_headers/'].get
  update:
    x-apievangelist-phrasing:
      intent: List print headers
      effect: read
      questions:
      - Which print headers are available for printed documents in Elation?
      - Can I page through print headers in a chosen order?
      instructions:
      - text: List print headers ordered by {order_by}.
        slots:
          order_by: query.order_by
      - text: Show the first {limit} v2 print headers.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/print_headers/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one print header
      effect: read
      questions:
      - How do I read the details of one print header in v2?
      - What does a v2 print header record contain?
      instructions:
      - text: Get v2.0 print header {id}.
        slots:
          id: path.id
      - text: Retrieve v2 print header {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/print_headers/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a print header
      effect: destructive
      questions:
      - How do I delete a print header we no longer use?
      - Can an outdated letterhead be removed through the API?
      instructions:
      - text: Delete print header {id}.
        slots:
          id: path.id
      - text: Remove the outdated letterhead {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'