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

# Candidatos

> Endpoints para gerenciamento de candidatos.

## GET /api/candidates

Lista candidatos da organização.

### Query Params

| Param    | Tipo   | Descrição         |
| -------- | ------ | ----------------- |
| `search` | string | Busca por nome    |
| `status` | string | Filtro por status |

***

## POST /api/candidates

Cria um novo candidato.

```json theme={null}
{
  "name": "Pedro Alves",
  "email": "pedro@exemplo.com",
  "phone": "(11) 98888-7777",
  "status": "ACTIVE"
}
```

***

## GET /api/candidates/:id

Retorna o perfil do candidato com histórico de avaliações.

***

## PUT /api/candidates/:id

Atualiza dados do candidato.

***

## POST /api/candidates/:id/promote

Promove o candidato para aluno.

**Roles:** `ADMIN` / `SUPER_ADMIN`

### Resposta

```json theme={null}
{
  "success": true,
  "studentId": "novo_student_id"
}
```

***

## DELETE /api/candidates/:id

Remove o candidato. **Roles:** `ADMIN` / `SUPER_ADMIN`