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

# Atualizar status de usuários

> Ative ou bloqueie usuários existentes usando e-mail ou CPF.

Atualiza o status de um ou mais alunos da empresa associada ao token. O corpo deve ser um array JSON.

## Corpo da requisição

<ParamField body="email" type="string">
  E-mail usado para localizar o usuário. Envie `email`, `cpf` ou ambos.
</ParamField>

<ParamField body="cpf" type="string">
  CPF usado para localizar o usuário. Envie `cpf`, `email` ou ambos.
</ParamField>

<ParamField body="status" type="integer">
  Use `1` para ativo ou `2` para bloqueado. Quando omitido, o status atual é mantido.
</ParamField>

```bash cURL theme={null}
curl -X PUT https://api.crescamais.com/integrations/users \
  -H "Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "email": "joao@empresa.com",
      "status": 2
    },
    {
      "cpf": "18498670039",
      "status": 1
    }
  ]'
```

## Resposta

```json theme={null}
{
  "message": "Integration update process completed.",
  "results": [
    {
      "user": {
        "email": "joao@empresa.com",
        "status": 2
      },
      "status": "updated",
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "timestamp": "2026-09-03T12:00:00.000Z"
}
```

| Resultado | Significado                                   |
| --------- | --------------------------------------------- |
| `updated` | O status foi atualizado.                      |
| `skipped` | O item não foi atualizado. Consulte `reason`. |

Os motivos de `skipped` são `Email or CPF required`, `Invalid CPF` e `User not found`.

## Erros

| Status | Causa                                  |
| ------ | -------------------------------------- |
| `401`  | Token ausente, malformado ou inválido. |
| `500`  | Erro interno durante o processamento.  |