PATCH/api/users

Atualizar usuário

Atualiza um usuário existente

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
acceptOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)

Parâmetros

idOBRIGATÓRIO
Tipo:number
ID do usuário

Este parâmetro representa o identificador único do usuário que será atualizado. O ID do usuário deve ser um número inteiro que identifica um usuário específico no sistema.

Observação: Para encontrar o ID do usuário, para acessar a página de listar todos os usuários.

nameOBRIGATÓRIO
Tipo:string
Nome do usuário
emailOBRIGATÓRIO
Tipo:string
Email do usuário
passwordOBRIGATÓRIO
Tipo:string
Senha do usuário
phoneOPCIONAL
Tipo:string
Telefone do usuário
rolesIdsOPCIONAL
Tipo:array
IDs dos perfis (roles) do usuário

Este parâmetro representa os IDs dos perfis (roles) que serão associados ao usuário. Deve ser um array de números inteiros.

Observação: Para encontrar os IDs dos perfis, para acessar a página de buscar todas as permissões.

Atenção: Este parâmetro precisa estar no formato de array. Caso não seja passado como array ou esteja vazio, a API retornará um erro 400 Bad Request com a mensagem "É necessário pelo menos 1 Grupo de usuário" e "rolesIds must be an array".

Request URL

https://api-dev.imagemais.com/api/users
curl -X 'PATCH' \
  'https://api-dev.imagemais.com/api/users' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjMyLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NjM5ODU2NSwiZXhwIjoxNzY2NDAyMTY1LCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.OkHP3JfIF-lijcHsmtF4cMNRcWF7aRslzT9Kq41YCjg' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "ekko rei do lol",
  "email": "ekko.lol@example.com",
  "password": "Ekko@123",
  "phone": "(81) 98888-7777",
  "rolesIds": [1],
  "id": 47
}'
{
  "name": "ekko rei do lol",
  "email": "ekko.lol@example.com",
  ...
{
  "name": "ekko rei do lol",
  "email": "ekko.lol@example.com",
  "password": "Ekko@123",
  "phone": "(81) 98888-7777",
  "rolesIds": [
    1
  ],
  "id": 47
}

Respostas

{
  "id": 47,
  "accountId": 1,
  ...
{
  "id": 47,
  "accountId": 1,
  "name": "ekko rei do lol",
  "email": "ekko.lol@example.com",
  "statusId": 1,
  "phone": "(81) 98888-7777",
  "lastLogin": null,
  "pictureId": null,
  "createdAt": "2025-12-19T19:01:13.637Z",
  "updatedAt": "2025-12-22T10:27:22.635Z"
}
{
  "message": [
    "name should not be empty",
  ...
{
  "message": [
    "name should not be empty",
    "name must be longer than or equal to 5 characters",
    "name must be a string"
  ]
}
{
  "message": [
    "email must be an email",
  ...
{
  "message": [
    "email must be an email",
    "email should not be empty",
    "email must be longer than or equal to 5 characters",
    "email must be a string"
  ]
}
{
  "message": [
    "password is not strong enough",
  ...
{
  "message": [
    "password is not strong enough",
    "password should not be empty",
    "password must be longer than or equal to 8 characters",
    "password must be a string"
  ]
}
{
  "message": [
    "id must be an integer number",
  ...
{
  "message": [
    "id must be an integer number",
    "id must be a positive number",
    "id must be a number conforming to the specified constraints"
  ]
}
{
  "message": [
    "É necessário pelo menos 1 Grupo de usuário",
  ...
{
  "message": [
    "É necessário pelo menos 1 Grupo de usuário",
    "rolesIds must be an array"
  ]
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}