# 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 Form Submissions API
  version: 1.0.0
extends: openapi/elation-health-patient-form-submissions-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: 3
- target: $.paths['/api/2.0/patient_form_submissions/'].get
  update:
    x-apievangelist-phrasing:
      intent: List patient form submissions
      effect: read
      questions:
      - How do I see the intake forms a patient has already submitted?
      - Can I page through completed form submissions sorted by date?
      instructions:
      - text: List form submissions from patient {patient}.
        slots:
          patient: query.patient
      - text: Page through submitted forms {limit} at a time from offset {offset}, ordered by {order_by}.
        slots:
          limit: query.limit
          offset: query.offset
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient_form_submissions/'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a patient's completed form
      effect: write
      questions:
      - How do I push a patient's completed questionnaire answers into their chart?
      - Can I link a form submission to an appointment and set its document date?
      instructions:
      - text: Submit form {patient_form} for patient {patient} with responses {form_response_json}.
        slots:
          patient_form: requestBody.patient_form
          patient: requestBody.patient
          form_response_json: requestBody.form_response_json
      - text: Record completed form {form_name} for appointment {appointment} dated {document_date}.
        slots:
          form_name: requestBody.form_name
          appointment: requestBody.appointment
          document_date: requestBody.document_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient_form_submissions/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a patient form submission
      effect: read
      questions:
      - How do I read the answers from one submitted patient form?
      - When was a specific form submission reported?
      instructions:
      - text: Retrieve form submission {id}.
        slots:
          id: path.id
      - text: Show the responses in submitted form {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'