---
title: "Delete Unit"
method: DELETE
path: "/teacher/courses/{course_id}/units/{unit_id}"
tags: ["Teacher Course Structure"]
---

# Delete Unit

`DELETE /teacher/courses/{course_id}/units/{unit_id}`

## 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/teacher/courses/{course_id}/units/{unit_id}`
- Auth: OAuth 2 (password, token URL `api/login`)

Delete a unit from the course.

Optionally preserve the unit's flashcards and QCMs as global course content.

## Path parameters

- `course_id` string, required
- `unit_id` string, required

## Request body

- DeleteUnitRequest: Request model for unit deletion with optional content preservation.
  - `preserve_content` boolean: Whether to preserve flashcards/QCMs as global content

## Response `200`

Successful Response

- CourseStructureResponse: Response model for course structure operations.
  - `status` string, required
  - `message` string, required
  - `course` Course, required: Represents a user course created through image uploads.
    - `_id` string
    - `user_id` string, required
    - `is_teacher_course` boolean
    - `folder_id` string, nullable
    - `title` string, required
    - `subject` string, nullable
    - `status` 'UPLOADING' | 'PROCESSING_IMAGES' | 'STRUCTURING' | 'GENERATING_CONTENT' | 'COMPLETED' | 'FAILED'
    - `original_image_paths` string[]
    - `raw_content_blob` string, nullable
    - `units` CourseUnit[], nullable
      - `unit_id` string
      - `type` 'chapter' | 'section' | 'topic' | 'concept_explanation' | 'introduction' | 'conclusion' | 'content' | 'flashcards' | 'qcm', required: Valid unit types for course content
      - `title` string, required
      - `unit_summary` string, required
      - `suggested_content_type` 'chapter' | 'section' | 'topic' | 'concept_explanation' | 'introduction' | 'conclusion' | 'content' | 'flashcards' | 'qcm': Valid unit types for course content
      - `brief_description` string, nullable
      - `generated_content` string, nullable
      - `blocks` CourseBlock[], nullable
        - `id` string, required
        - `type` 'paragraph' | 'theorem' | 'definition' | 'example' | 'property' | 'explanation' | 'note' | 'demonstration' | 'illustration' | 'video' | 'interactive', required
        - `content` string, required
    - `generated_course_content` string, nullable
    - `revision_deck_status` 'GENERATING' | 'COMPLETED' | 'FAILED', nullable
    - `knowledge_quiz_status` 'GENERATING' | 'COMPLETED' | 'FAILED', nullable
    - `append_status` 'GENERATING' | 'COMPLETED' | 'FAILED', nullable
    - `append_started_at` string, date-time, nullable
    - `append_error_message` string, nullable
    - `error_message` string, nullable
    - `warnings` string[], nullable
    - `figures_crop` object, nullable
    - `processing_options` object, nullable
    - `source_type` 'student_upload' | 'teacher_assigned' | 'holiday_workbook' | 'excellence_course', nullable
    - `excellence_course_key` string, nullable
    - `excellence_content_signature` string, nullable
    - `excellence_unmodified` boolean, nullable
    - `holiday_course_context` object, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-15** `7925dd21e4d0`: 3 warning, 6 info
  - added the new `excellence_course` enum value to the `course/source_type/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `interactive` enum value to the `course/units/anyOf[subschema #1]/items/blocks/anyOf[subschema #1]/items/type` response property for the response status `200`
  - added the new `video` enum value to the `course/units/anyOf[subschema #1]/items/blocks/anyOf[subschema #1]/items/type` response property for the response status `200`
  - added the optional property `course/append_error_message` to the response with the `200` status
  - …5 more
- **2026-09-19** `c81ed506912f`: 1 info
  - added the optional property `course/units/anyOf[subschema #1]/items/blocks` to the response with the `200` status

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/teacher/courses/:course_id/units/:unit_id/delete.md)

---

[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)