> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hawkings.education/llms.txt
> Use this file to discover all available pages before exploring further.

# The Assignment object

> A gradable artefact tied to a lesson.

```json Example theme={null}
{
  "id": "asg_01HX9N5AB3...",
  "object": "assignment",
  "lesson_id": "lsn_01HX9...",
  "type": "essay",
  "title": "Explain mass-energy equivalence",
  "description": null,
  "due_at": "2026-06-01T23:59:00Z",
  "rubric": {
    "scale": { "min": 0, "max": 10 },
    "criteria": [
      { "name": "clarity",  "weight": 0.4 },
      { "name": "accuracy", "weight": 0.4 },
      { "name": "sources",  "weight": 0.2 }
    ]
  },
  "ai_evaluator": {
    "enabled": true,
    "model": "claude-sonnet-4-6"
  },
  "human_review": "required",
  "feedback": { "tone": "encouraging", "verbosity": "normal" },
  "submissions_count": 38,
  "created_at": "2026-05-10T12:00:00Z"
}
```

## Attributes

<ResponseField name="id" type="string">Prefix `asg_`.</ResponseField>

<ResponseField name="lesson_id" type="string" />

<ResponseField name="type" type="enum">`essay` | `upload` | `code` | `oral` | `project`.</ResponseField>

<ResponseField name="title" type="string" />

<ResponseField name="description" type="string | null" />

<ResponseField name="due_at" type="string | null">ISO 8601.</ResponseField>

<ResponseField name="rubric" type="Rubric" />

<ResponseField name="ai_evaluator" type="object" />

<ResponseField name="human_review" type="enum">`required` | `optional` | `off`.</ResponseField>

<ResponseField name="feedback" type="object" />

<ResponseField name="submissions_count" type="integer" />