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

# Universities API

> Endpoints for managing university profiles

## Overview

The Universities API allows you to list, create, update, and delete universities.

## Endpoints

### List Universities

`GET /universities`

Lists all active universities with pagination and search.

* **Query Parameters**:
  * `page`: Page number (default: 1)
  * `limit`: Items per page (default: 20)
  * `search`: Filter by name or short name
  * `isActive`: Filter by active status (true/false/all)

### Get University by Slug

`GET /universities/:slug`

Retrieves a single university by its unique slug.

### Create University

`POST /universities`

Creates a new university.

* **Auth**: Required (`admin` or `editor`)
* **Body**: See [University Model](/backend/models-database#university)

### Update University

`PATCH /universities/:id`

Updates an existing university.

* **Auth**: Required (`admin` or `editor`)
* **Body**: Partial [University Model](/backend/models-database#university)

### Delete University

`DELETE /universities/:id`

Soft-deletes a university.

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