PATCH Atualizar Status do Usuário
Alterna o status do usuário nesta clínica entre ativo e inativo (expirado). É um toggle: se está ativo, passa a inativo, e vice-versa.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão update_users.
Efeito no acesso
Inativar desativa o vínculo da pessoa com a clínica no provedor de identidade, encerra as sessões abertas dela nesta clínica (inclusive WebSockets) e faz os tokens já emitidos serem recusados com 401 — "Usuário desativado". Reativar restaura o acesso. O acesso da pessoa a outras clínicas não muda.
Endpoint
PATCH https://api-dev.imagemais.com.br/api/users/status
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do usuário |
Requisição
curl -X 'PATCH' \n 'https://api-dev.imagemais.com.br/api/users/status' \n -H 'accept: application/json' \n -H 'Authorization: Bearer {accessToken}' \n -H 'Content-Type: application/json' \n -d '{
"id": 12
}'
Respostas
200 Sucesso
{
"message": "Status atualizado com sucesso",
"status": 200
}
400 Usuário sem acesso pelo novo login
{
"message": "Esse usuário ainda não tem acesso pelo novo login.",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Usuário não encontrado
{
"message": "Usuário não encontrado",
"error": "Not Found",
"statusCode": 404
}
503 Serviço de login indisponível
{
"message": "Não foi possível falar com o serviço de login. Tente novamente em instantes.",
"error": "Service Unavailable",
"statusCode": 503
}