--- title: "Submit" method: POST path: "/api/asclepius/submissions" tags: ["asclepius"] --- # Submit `POST /api/asclepius/submissions` ## 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/submissions` - Auth: none declared ## Query parameters - `async_pipeline` boolean: Real submit progress (BUG-5): when true, return 202 + submission_id immediately and run the pipeline as a background job; poll GET /submissions/{id}/status for backend-stamped phases. Default false keeps the synchronous 200 + result behavior. ## 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)