Endpoint: PUT/PATCH /user/users/{id}/
Autenticação: JWT obrigatório
Atualiza o usuário. PATCH é parcial; PUT exige a representação completa. Definir password aciona a rotina de hash de senha, garantindo que o valor seja armazenado corretamente. A validação também impede a alteração de username ou email para um valor já usado por outro usuário — caso isso ocorra, é retornado um erro de validação.

Pré-requisitos

  • Quem faz a chamada precisa ser superusuário ou possuir a permissão auth.manage_users.

Parâmetros de rota

id
integer
required
Identificador do usuário.

Corpo da requisição

username
string
Novo nome de login. Precisa permanecer único.
email
string
Novo e-mail. Precisa permanecer único.
password
string
Nova senha. Armazenada com hash.
is_superuser
boolean
is_active
boolean
Defina como false para desativar o login sem apagar a conta.

Resposta

Retorna o usuário atualizado (sem a senha).
{
  "id": 42,
  "username": "voce@example.com",
  "email": "voce@example.com",
  "is_superuser": false,
  "is_active": true,
  "date_joined": "2025-01-12T10:24:11.000000Z"
}

Erros

StatusQuando
400Falha de validação (por exemplo, username ou email já existe em outro usuário).
401Token ausente ou inválido.
403Quem chama não possui auth.manage_users.
404Nenhum usuário corresponde ao identificador informado.

Exemplos

curl -X PATCH https://api.dlpay.cloud/user/users/42/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"is_active": false}'