← Back to API Explorer
How it works

From routing data to classroom-ready worksheets.

The routing layer pre-selects the pedagogical thread, metalanguage concept, and arc trajectory for the current learning cycle. Your platform consumes this via a single API call and routes the data into a template engine that produces both teacher-facing guides and student-facing worksheets simultaneously — the Dual-Surface output.

Input: GET /routing/the-outsiders/thread-focus
{ "thread_name": "Fraternal Interdependence and Trauma-Driven Transformation", "concept": "Fraternal Interdependence", "lens": "relational", "devices": ["Juxtaposition", "Symbolism", "Metaphor"], "arc_entries": [ { "chapter": 1, "arc_role": "introduced", "anchor_quote_count": 4 }, { "chapter": 6, "arc_role": "developed", "anchor_quote_count": 6 }, { "chapter": 9, "arc_role": "peaks", "anchor_quote_count": 7 } ] }
Defaults: GET /curation/the-outsiders/step-contracts?step=A1_arc_synthesis
// Curation contract — controls what each surface receives { "scaffold_level": "medium", "density_caps": { "max_events_per_task": 5, "max_words_per_evidence_block": 45 }, "audience_routing": { "student_surface": ["scaffold_text", "write_box", "arc_badge"], "teacher_surface": ["model_answer", "overflow_evidence"] } }
Output: Dual-Surface worksheet scaffold
// Student surface — receives scaffold_text, write_box, arc_badge only { "surface": "student", "concept": "Fraternal Interdependence", "arc_badge": "introduced → developed → peaks", "scaffold_text": "In The Outsiders, Fraternal Interdependence is initially presented as… because…", "write_box_lines": 6 } // Teacher surface — receives model_answer, overflow_evidence { "surface": "teacher", "model_answer": "Ponyboy's retrospective narration positions brotherhood as the primary survival mechanism...", "overflow_evidence": ["Ch.1 ID:4", "Ch.6 ID:31", "Ch.9 ID:58"] }
What you get

Infrastructure, not one-off documents.

The same kernel that generates a worksheet for The Outsiders generates one for Macbeth, The Giver, or any text in the corpus — without any additional human authoring. The structural pattern is domain-invariant; only the verified quotes change.

Output Type A

Dual-Surface Teacher + Student Package

One API call per step produces a teacher guide (model answers, overflow evidence, routing metadata) and a paired student worksheet (scaffold text, write boxes, arc badges) with audience isolation enforced by the curation contract.

Output Type B

Annotation Preview Pages

Convert evidence arrays directly into downloadable annotation guides — chapter-by-chapter visual breakdowns that serve as PLG assets and infrastructure proof for B2B partners.

Explore the source data in the API Explorer →