# Hawkings

> The infrastructure for AI-native education. Build courses, lessons, quizzes, AI tutors, and grading on top of one API.

## Docs

- [Create an activity](https://docs.hawkings.education/api-reference/activities/create.md): Create a single activity by type. Async — the body is generated by the AI unless you pass `questions` explicitly.
- [Evaluate an activity](https://docs.hawkings.education/api-reference/activities/evaluate.md): Submit answers and get a Submission back.
- [Generate activities](https://docs.hawkings.education/api-reference/activities/generate.md): Generate a mix of activities for one or more lessons in one call.
- [The Activity object](https://docs.hawkings.education/api-reference/activities/object.md): Anything inside a lesson that the learner *does*. 22 types, one schema.
- [Tutor chat](https://docs.hawkings.education/api-reference/activities/tutor.md): Per-activity grounded chat. Threads, messages, streaming.
- [Configure an assignment](https://docs.hawkings.education/api-reference/assignments/configure.md): Tune the rubric, AI evaluator, and feedback style.
- [Create an assignment](https://docs.hawkings.education/api-reference/assignments/create.md)
- [The Assignment object](https://docs.hawkings.education/api-reference/assignments/object.md): A gradable artefact tied to a lesson.
- [Create a cohort](https://docs.hawkings.education/api-reference/cohorts/create.md): Start a new run of a course for a group of students.
- [List cohorts](https://docs.hawkings.education/api-reference/cohorts/list.md)
- [The Cohort object](https://docs.hawkings.education/api-reference/cohorts/object.md): A run of a Course for a group of students at a moment in time.
- [Retrieve a cohort](https://docs.hawkings.education/api-reference/cohorts/retrieve.md)
- [List enrolled students](https://docs.hawkings.education/api-reference/cohorts/students.md): Sugar for `users.list({ role: 'student', cohort_id })`.
- [Clone a course](https://docs.hawkings.education/api-reference/courses/clone.md): Duplicate a course, including its syllabus tree and AI configuration. Cohorts and submissions are not copied.
- [Create a course](https://docs.hawkings.education/api-reference/courses/create.md): Create an empty course (status `draft`). Generate a syllabus next.
- [Generate a syllabus](https://docs.hawkings.education/api-reference/courses/generate-syllabus.md): Generate a unit/lesson tree with learning objectives. Async.
- [List courses](https://docs.hawkings.education/api-reference/courses/list.md): Paginated list of courses in the current workspace.
- [The Course object](https://docs.hawkings.education/api-reference/courses/object.md): The syllabus / curriculum. Holds units, lessons, and AI configuration.
- [Retrieve a course](https://docs.hawkings.education/api-reference/courses/retrieve.md): Fetch a course by ID, optionally inlining related resources.
- [Update a course](https://docs.hawkings.education/api-reference/courses/update.md): Update name, AI instructions, metadata, and so on. Patch semantics.
- [Create a lesson](https://docs.hawkings.education/api-reference/lessons/create.md)
- [List lessons](https://docs.hawkings.education/api-reference/lessons/list.md)
- [The Lesson object](https://docs.hawkings.education/api-reference/lessons/object.md): The atomic learning unit. Holds content, activities, and at most one assignment.
- [Retrieve a lesson](https://docs.hawkings.education/api-reference/lessons/retrieve.md)
- [API reference overview](https://docs.hawkings.education/api-reference/overview.md): Every resource, every method, in one place.
- [Create a SCORM package](https://docs.hawkings.education/api-reference/scorm/create.md): Generate a SCORM 1.2 or 2004 zip from a cohort. Async.
- [Download a SCORM package](https://docs.hawkings.education/api-reference/scorm/download.md): Stream the zip. Signed URL valid for 24 hours.
- [The ScormPackage object](https://docs.hawkings.education/api-reference/scorm/object.md): An exportable SCORM zip generated from a cohort.
- [Create a submission](https://docs.hawkings.education/api-reference/submissions/create.md)
- [Grade with AI](https://docs.hawkings.education/api-reference/submissions/grade-with-ai.md): Score a submission against the assignment's rubric. Async.
- [List submissions](https://docs.hawkings.education/api-reference/submissions/list.md)
- [The Submission object](https://docs.hawkings.education/api-reference/submissions/object.md): A student's response to an assignment, plus its grade.
- [Create a user](https://docs.hawkings.education/api-reference/users/create.md)
- [List users](https://docs.hawkings.education/api-reference/users/list.md)
- [The User object](https://docs.hawkings.education/api-reference/users/object.md): Anyone with access to a workspace. Roles: `student`, `teacher`, `manager`, `admin`.
- [Create a workspace](https://docs.hawkings.education/api-reference/workspaces/create.md): Provision a new tenant.
- [List workspaces](https://docs.hawkings.education/api-reference/workspaces/list.md): All workspaces this API key has access to.
- [The Workspace object](https://docs.hawkings.education/api-reference/workspaces/object.md): A tenant. Holds users and courses.
- [Retrieve a workspace](https://docs.hawkings.education/api-reference/workspaces/retrieve.md)
- [Authentication](https://docs.hawkings.education/authentication.md): How API keys, scopes, and platforms work.
- [Activities & Questions](https://docs.hawkings.education/concepts/activities-and-questions.md): The 22 activity types, when to use each, and how questions work.
- [AI generation](https://docs.hawkings.education/concepts/ai-generation.md): How async generation works, polling vs webhooks, and grounded research.
- [AI grading](https://docs.hawkings.education/concepts/ai-grading.md): How AI grading works, what it returns, and how to keep a human in the loop.
- [Assignments & Submissions](https://docs.hawkings.education/concepts/assignments-and-submissions.md): Gradable artefacts: rubrics, due dates, AI grading, human-in-the-loop.
- [Courses vs. Cohorts](https://docs.hawkings.education/concepts/courses-vs-cohorts.md): Why Hawkings splits the curriculum from the run, and when each one matters.
- [Data model](https://docs.hawkings.education/concepts/data-model.md): The full graph: workspaces → courses → cohorts → lessons → activities → questions.
- [The grading API](https://docs.hawkings.education/concepts/grading-api-design.md): Score student work against a rubric with AI. Four resources, a stateful job, webhooks, batch, and terminal guarantees.
- [Modeling real-world courses](https://docs.hawkings.education/concepts/modeling-real-world-courses.md): Three worked examples — a Moodle course, a Spanish vocational training program, and a US university subject — using the same Hawkings primitives.
- [Errors & retries](https://docs.hawkings.education/errors-and-retries.md): Error taxonomy, idempotency, automatic retries.
- [Build an AI tutor](https://docs.hawkings.education/guides/build-an-ai-tutor.md): Add a per-lesson, grounded tutor chat to your product.
- [Export to SCORM](https://docs.hawkings.education/guides/export-to-scorm.md): Hand a Hawkings cohort to Moodle, Canvas, Cornerstone — anything SCORM-compatible.
- [Generate a course from a syllabus](https://docs.hawkings.education/guides/generate-a-course-from-a-syllabus.md): From a paragraph of text to a fully-structured, ready-to-teach course.
- [Grade an open-ended answer](https://docs.hawkings.education/guides/grade-an-open-ended-answer.md): Wire AI grading with a rubric, then put a human in the loop.
- [Sync students from your LMS](https://docs.hawkings.education/guides/sync-students-from-your-lms.md): Bring your existing roster — once, daily, or in real time.
- [Introduction](https://docs.hawkings.education/introduction.md): Hawkings is the infrastructure for AI-native education. One API to build courses, lessons, quizzes, AI tutors, and grading.
- [Pagination & expanding](https://docs.hawkings.education/pagination-and-expanding.md): How to walk lists and how to fetch related objects in one round-trip.
- [Quickstart](https://docs.hawkings.education/quickstart.md): From zero to your first AI-generated lesson in under 60 seconds.

## OpenAPI Specs

- [openapi](https://docs.hawkings.education/api-reference/openapi.json)