---
title: "Generate Structured Subject"
method: POST
path: "/student-exams/{exam_id}/generate-structured-subject"
tags: ["student-exams"]
---

# Generate Structured Subject

`POST /student-exams/{exam_id}/generate-structured-subject`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/student-exams/{exam_id}/generate-structured-subject`
- Auth: OAuth 2 (password, token URL `api/login`)

Generate a structured exam subject with individual exercises.
This is the new preferred method that mirrors teacher exam functionality.

## Path parameters

- `exam_id` string, required

## Request body

- GenerateStructuredSubjectRequest
  - `class_level` string, required
  - `chapters` string, required
  - `thematics` string, required
  - `difficulty` integer, required
  - `number_of_exercises` integer, required
  - `exam_title` string, nullable
  - `time_limit` string, nullable

## Response `200`

Successful Response

- GetStructuredExercisesResponse
  - `status` string, required
  - `exercises` object[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)