---
title: "Tutorial Submit"
method: POST
path: "/api/asclepius/tutorial/submit"
tags: ["asclepius"]
---

# Tutorial Submit

`POST /api/asclepius/tutorial/submit`

## Request

- Base URL: `https://app.archangelhealth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.archangelhealth.ai/api/asclepius/tutorial/submit`
- Auth: none declared

Grade the practice submission, and DECIDE whether it passed.

This is the pass decision, not just feedback. The practice case gates all
real work, so "completed" had to stop meaning "clicked through": before
this, a 0-of-4 stamped ``completed`` and that was the only thing between a
new physician and a paid case.

Never touches the real submit pipeline: no ``submissions`` row, no
``records``, no QA routing.

## Headers

- `authorization` string, nullable

## Request body

- SubmissionIn
  - `submission_id` string, nullable
  - `task_id` string, required
  - `verdict` string, nullable
  - `prompt_review` PromptReview: Stage-1 clinician sign-off on the prompt itself (Eval Flow Upgrade §2). A ``valid`` verdict upgrades provenance from AI-drafted to clinician-reviewed and carries onto every shipped record. A ``flagged`` verdict short-circuits capture: the task is flagged for admin review and 0 records are produced.
    - `reviewed` boolean
    - `verdict` string, nullable
    - `note` string, nullable
    - `reviewed_at` string, nullable
    - `attest_clinically_valid` boolean, nullable
  - `independent_answer` IndependentAnswer: Stage-2 blind capture — written BEFORE the A/B candidates are revealed (Eval Flow Upgrade §3). ``kind`` (Speed Optimization §1) distinguishes the default quick ``stance`` (anti-anchoring signal; the gold SFT answer comes from the refined chosen answer) from a ``full`` blind ideal answer (uncontaminated premium SFT). The server stamps ``kind`` from the task's ``independent_mode`` at reveal — it is never trusted from the client.
    - `text` string
    - `kind` string, nullable
    - `portal_version` string, nullable
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `evidence_anchors` EvidenceAnchor[]
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `captured_at` string, nullable
  - `independent_answer_revision` IndependentAnswerRevision: Server-derived correction after reveal; never a blind training target.
    - `text` string
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `evidence_anchors` EvidenceAnchor[]
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `capture_phase` string
    - `revised_at` string, nullable
  - `chosen_id` string, nullable
  - `rejected_id` string, nullable
  - `chosen_revision` ChosenRevision
    - `edited` boolean
    - `revised_text` string, nullable
    - `why_better_tags` string[]
    - `why_better_notes` string, nullable
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `evidence_anchors` EvidenceAnchor[]
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
  - `rejected_critique` RejectedCritique
    - `error_tags` string[]
    - `severities` object
    - `why_worse` string, nullable
    - `error_tag_anchors` object
    - `error_tag_reasons` object
    - `failure_tags` FailureTag[]
      - `mode` string
      - `evidence_step_id` string, nullable
      - `criterion_id` string, nullable
      - `note` string
      - `tier` string, nullable
  - `from_scratch` FromScratch
    - `ideal_answer` string
    - `approach_notes` string, nullable
    - `reasoning_steps` ReasoningStep[]
      - `step` integer, required
      - `text` string, required
      - `original_text` string, nullable
      - `corrected` boolean
      - `confirmed` boolean
      - `added` boolean
      - `correction_reason` string, nullable
      - `step_note` string, nullable
      - `step_error_tag` string, nullable
      - `label` string, nullable
      - `step_reward` number, nullable
      - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
        - `citation_text` string, nullable
        - `source_type` string, nullable
        - `identifier` string, nullable
        - `url` string, nullable
        - `citation_confirmed` boolean, nullable
        - `entry_method` string, nullable
      - `evidence_anchors` EvidenceAnchor[]
        - `citation_text` string, nullable
        - `source_type` string, nullable
        - `identifier` string, nullable
        - `url` string, nullable
        - `citation_confirmed` boolean, nullable
        - `entry_method` string, nullable
      - `critique` string, nullable
      - `suggested_label` string, nullable
      - `suggested_critique` string, nullable
      - `tag` string, nullable
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `evidence_anchors` EvidenceAnchor[]
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
  - `reasoning_steps` ReasoningStep[]
    - `step` integer, required
    - `text` string, required
    - `original_text` string, nullable
    - `corrected` boolean
    - `confirmed` boolean
    - `added` boolean
    - `correction_reason` string, nullable
    - `step_note` string, nullable
    - `step_error_tag` string, nullable
    - `label` string, nullable
    - `step_reward` number, nullable
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `evidence_anchors` EvidenceAnchor[]
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `critique` string, nullable
    - `suggested_label` string, nullable
    - `suggested_critique` string, nullable
    - `tag` string, nullable
  - `rubric` RubricCriterion[]
    - `text` string
    - `points` number
    - `axes` string[]
    - `axis` string, nullable
    - `source` string, nullable
    - `tier` string, nullable
    - `critical` boolean
    - `evidence_anchor` EvidenceAnchor: A citation grounding a judgment/step in a clinical source. ``{citation_text, source_type, identifier}`` — e.g. KDIGO 2024 §3.2, a PMID, or a DOI. Captured with one keystroke in the UI; carried onto every record so grounded data can be filtered to a premium tier and verified by the critic.
      - `citation_text` string, nullable
      - `source_type` string, nullable
      - `identifier` string, nullable
      - `url` string, nullable
      - `citation_confirmed` boolean, nullable
      - `entry_method` string, nullable
    - `specific` boolean, nullable
  - `confidence` string
  - `time_spent_sec` integer
  - `assisted` string[]
  - `portal_version` string, nullable
  - `assist` object, nullable
  - `decisive_action` object, nullable
  - `expected_trajectory` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform.md) - [All operations](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform/revisions/3514f4e119da?raw)
