Promover Usuário
Descrição
Atualiza a role de um usuário existente no sistema. Verifica se o ID do usuário e o role_id fornecido são válidos.
Verbo
PUT
URL Base
https://api.soargi.com
Endpoint
/users/{id}/promote
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer Token |
Corpo da Requisição
{
"role_id": 2
}
Campos Esperados
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| role_id | integer | Sim | ID da nova role a ser atribuída ao usuário. |
Roles disponíveis
| ID | Nome |
|---|---|
| 1 | Admin |
| 2 | Gest |
| 3 | Individual |
| 4 | Institutional |
| 5 | Master Practitioner |
| 6 | Partner |
| 7 | Practitioner |
| 8 | Super Admin |
Sucesso - 200
{
"success": true,
"message": "User role updated successfully.",
"user_id": 5,
"role_id": 7,
"role_name": "Practitioner"
}
Erro - 422 (Campo ausente)
{
"status": 422,
"error": "New role_id is required."
}
Erro - 404 (Usuário não encontrado)
{
"status": 404,
"error": "User not found."
}
Erro - 422 (Role inválida)
{
"status": 422,
"error": "The specified role_id does not exist."
}
Códigos de Resposta
- 200 - Usuário promovido com sucesso
- 422 - Campo obrigatório ausente ou inválido
- 404 - Usuário não encontrado