iblai-api-studio-outline

The IBL course-creator app on Studio adds api/v1/ibl/… routes that wrap the stock /xblock/ handler for bulk work. create_full_course walks a JSON spec — sections → subsections → units → components — creates everything inside one modulestore transaction and publishes the whole course at the end. A five-section course with text and quizzes becomes one request instead of a hundred.

Before you start

0. Three situations, three tools. New, empty course → create_full_course (below; it appends and then publishes the entire course, drafts included). One section, lesson, unit or component of an existing course → the individual skills (/iblai-api-studio-section, -subsection, -unit, -html, -problem, -pdf), which act on one locator. Many changes to an existing course (rewrite readings, add units across lessons, restructure) → the reconcile driver (section "Bulk edits to an existing course" below), which diffs the same spec against the live outline and only touches what differs.
1. Preflight: node .claude/skills/iblai-api-studio-auth/scripts/studio-login.mjs --check must print two oks — otherwise run /iblai-api-studio-auth first, do not attempt the calls below.
2. A course key from /iblai-api-studio-course-create; the user must be instructor on it (the creator is). For create_full_course, confirm with GET /xblock/outline/{ROOT} that child_info.children is empty; for the reconcile driver, that outline is the baseline it diffs against.
3. Settings and grading first (/iblai-api-studio-settings, /iblai-api-studio-grading): this call publishes, and pacing cannot change after the course start.
4. The outline planned per /iblai-api-studio "Planning a production-grade outline" and reviewed with the user.
5. If sub-agents wrote parts of the spec: they worked from the same content brief, and every fragment has been reviewed against it (/iblai-api-studio "Content quality") — consistent voice and headings, no thin or placeholder units, valid OLX, titles on every block. The builder posts whatever it is given and publishes it; divergent or shallow content goes live verbatim.

Auth & conventions