Atualizar usuário

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

integer

required

Identificador do usuário.

Corpo da requisição

string

Novo nome de login. Precisa permanecer único.

string

Novo e-mail. Precisa permanecer único.

string

Nova senha. Armazenada com hash.

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

Status	Quando
`400`	Falha de validação (por exemplo, `username` ou `email` já existe em outro usuário).
`401`	Token ausente ou inválido.
`403`	Quem chama não possui `auth.manage_users`.
`404`	Nenhum 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}'

import requests

response = requests.patch(
    "https://api.dlpay.cloud/user/users/42/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"is_active": False},
)
user = response.json()

const response = await fetch("https://api.dlpay.cloud/user/users/42/", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ is_active: false }),
});
const user = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pré-requisitos

Parâmetros de rota

Corpo da requisição

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Corpo da requisição

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Corpo da requisição

Resposta

Erros

Exemplos