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

# Alunos

> Endpoints para gerenciamento de alunos.

## GET /api/students

Lista alunos da organização do usuário autenticado.

### Query Params

| Param    | Tipo   | Descrição                                 |
| -------- | ------ | ----------------------------------------- |
| `search` | string | Busca por nome                            |
| `status` | string | ACTIVE / INACTIVE / SUSPENDED / GRADUATED |
| `page`   | number | Página                                    |
| `limit`  | number | Itens por página                          |

***

## POST /api/students

Cria um novo aluno. Aceita todos os campos de perfil via `multipart/form-data` ou JSON.

**Campos mínimos:**

```json theme={null}
{
  "name": "Ana Lima",
  "status": "ACTIVE"
}
```

***

## GET /api/students/:id

Retorna um aluno com todos os dados de perfil e histórico de submissões.

***

## PUT /api/students/:id

Atualiza os dados de um aluno.

***

## DELETE /api/students/:id

Soft delete do aluno. **Roles:** `ADMIN` / `SUPER_ADMIN`