> ## 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.

# Configure an assignment

> Tune the rubric, AI evaluator, and feedback style.

## Path parameters

<ParamField path="id" type="string" required />

## Body

<ParamField body="rubric" type="Rubric" />

<ParamField body="ai_evaluator" type="object">
  <Expandable title="properties">
    <ParamField body="enabled" type="boolean" />

    <ParamField body="model" type="string">e.g. `"claude-sonnet-4-6"`.</ParamField>
  </Expandable>
</ParamField>

<ParamField body="human_review" type="enum">`required` | `optional` | `off`.</ParamField>

<ParamField body="feedback" type="object">
  <Expandable title="properties">
    <ParamField body="tone" type="enum">`encouraging` | `neutral` | `demanding`.</ParamField>
    <ParamField body="verbosity" type="enum">`short` | `normal` | `detailed`.</ParamField>

    <ParamField body="language" type="string" />
  </Expandable>
</ParamField>

## Examples

<CodeGroup>
  ```ts TypeScript theme={null}
  await hk.assignments.configure("asg_123", {
    ai_evaluator: { enabled: true, model: "claude-sonnet-4-6" },
    human_review: "required",
    feedback: { tone: "encouraging", verbosity: "normal" },
  });
  ```

  ```php PHP theme={null}
  $hk->assignments->configure('asg_123', [
      'ai_evaluator' => ['enabled' => true, 'model' => 'claude-sonnet-4-6'],
      'human_review' => 'required',
      'feedback' => ['tone' => 'encouraging', 'verbosity' => 'normal'],
  ]);
  ```
</CodeGroup>

## Helpers

<CodeGroup>
  ```ts TypeScript theme={null}
  await hk.assignments.configureRubric(id, { criteria: [...] });
  await hk.assignments.configureFeedback(id, { tone: "demanding" });
  await hk.assignments.resetConfig(id);
  ```

  ```php PHP theme={null}
  $hk->assignments->configureRubric($id, ['criteria' => [/* ... */]]);
  $hk->assignments->configureFeedback($id, ['tone' => 'demanding']);
  $hk->assignments->resetConfig($id);
  ```
</CodeGroup>

## Returns

The updated [Assignment](/api-reference/assignments/object).