# Update a student

`POST https://{domain}/api/v1/usuario/update/{usuario_email_id}`

Operation ID: `users.update` · API v1

Updates the name, email, mobile phone and document of a student. A field that is missing or empty keeps its current value; other fields are ignored.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `usuario_email_id` | path | string | yes | The student, by ID, email or document (CPF). A value that is a valid email is looked up by email; otherwise the digits are matched against the ID and the document. |

## Request body

Content type: `application/json`.

| Field | Type | Required | Description |
|---|---|---|---|
| `celular` | string | no | Mobile phone. |
| `doc` | string | no | Document (CPF). |
| `email` | string (email) | no | Must not belong to another student. |
| `nome` | string | no | Name. |

## Responses

### 200

The updated student.

Body: object.

### 401

The Authorization header is missing, or the key does not exist or was deleted.

Body: HandlerError.

### 404

No route matches the path, for example a non-numeric ID where a number is expected.

Body: HandlerError.

### 409

Usuário não encontrado in the v1 envelope, or, in the shorter error body, an email that is invalid or already used by another student.

Body: Error or HandlerError.

Full schema: https://cademi.dev/openapi/v1.json