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

# Semesters API

> Endpoints for managing semesters

## Overview

Manage academic semesters under a branch.

## Endpoints

### List Semesters

`GET /semesters`

* **Query Parameters**:
  * `branchId`: Filter by branch

### Create Semester

`POST /semesters`

* **Auth**: Required (`admin` or `editor`)

### Update Semester

`PATCH /semesters/:id`

* **Auth**: Required (`admin` or `editor`)

### Delete Semester

`DELETE /semesters/:id`

* **Auth**: Required (`admin`)