POST /v2/courses/{course_id}/generate-notes
Generate study notes
Builds comprehensive, markdown-formatted study notes for a course — an introduction, one section per chapter (generated in parallel batches), and a conclusion. Notes are one of Nuton’s strongest features, tuned for retention.
Follows the same generate-then-retrieve pattern as the other materials: the first call for a course runs the full generation; later calls return the cached result instantly and are not charged again.
Request
Headers
| Header | Required | Notes |
|---|---|---|
X-API-Key | yes | |
X-External-User-Id | yes (or X-User-Id) | Must own the course |
Content-Type | yes | application/json |
Path parameters
course_id string (UUID) required The course to generate notes from. |
Body
All fields are optional — sensible defaults are applied.
model_key string Override the generation model. Defaults to the course's model. |
learning_goal string What the learner is optimizing for: exams (default), interviews, or practical. |
learning_style string Prose shape: clear_structured (default), narrative, or concise. |
tutor_tone string Voice of the notes: professor (default), mentor, or peer. |
{ "learning_goal": "exams", "tutor_tone": "mentor" }
Returns
{
"course_id": "550e8400-e29b-41d4-a716-446655440000",
"notes": "# Introduction\n\n...markdown...\n\n## Chapter 1\n...",
"cached": false
}
Retrieve previously generated notes any time with GET /v2/courses/{course_id}/notes.
Pricing: $0.05 per generation. Cached re-generation and all retrievals
(GET .../notes) are free. See Pricing for the full breakdown.
Errors
- 404 — Course not found, or no notes generated yet (on the
GET). - 422 — Unknown
model_key. - 503 — Upstream LLM unavailable. Retry with backoff.