# 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 Patient Forms API
  version: 1.0.0
extends: openapi/elation-health-patient-forms-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: 4
- target: $.paths['/patient_forms'].get
  update:
    x-apievangelist-phrasing:
      intent: Find patient forms by created date
      effect: read
      questions:
      - Which patient intake forms were created at my practice this month?
      - Can I find patient forms created between two dates?
      instructions:
      - text: Find patient forms for practice {practice}.
        slots:
          practice: query.practice
      - text: Find forms created on or after {created_date__gte} and on or before {created_date__lte}.
        slots:
          created_date__gte: query.created_date__gte
          created_date__lte: query.created_date__lte
      method: generated
      generated: '2026-09-26'
- target: $.paths['/patient_forms/:id'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a patient form (legacy Get)
      effect: read
      questions:
      - Is there an older call to get a patient form?
      - Can I get a patient form with the legacy Get Patient Form endpoint?
      instructions:
      - text: Get a patient form with the legacy Get Patient Form call.
      - text: Fetch the patient form via the older get endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient_forms/'].get
  update:
    x-apievangelist-phrasing:
      intent: List patient forms with paging
      effect: read
      questions:
      - Can I page through patient forms with limit and offset?
      - How do I list patient forms sorted by creation date?
      instructions:
      - text: List patient forms, {limit} per page.
        slots:
          limit: query.limit
      - text: List patient forms for {practice} ordered by {order_by}.
        slots:
          practice: query.practice
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient_forms/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a patient form
      effect: read
      questions:
      - How do I retrieve a single patient form by id?
      - Can I retrieve a completed patient form object?
      instructions:
      - text: Retrieve patient form {id}.
        slots:
          id: path.id
      - text: Retrieve the completed form {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'