POST Atribuir Role ao Usuário
Atribui uma role da clínica a um usuário. O usuário pode ter várias roles.
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 give_roles.
Endpoint
POST https://api-dev.imagemais.com.br/api/roles/users/{userId}
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
userId | number | ✅ | ID do usuário (inteiro positivo) |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
slug | string | ✅ | Slug da role (ex.: org-recepcao) |
Requisição
curl -X 'POST' \n 'https://api-dev.imagemais.com.br/api/roles/users/1' \n -H 'accept: application/json' \n -H 'Authorization: Bearer {accessToken}' \n -H 'Content-Type: application/json' \n -d '{
"slug": "org-recepcao"
}'
Respostas
200 Sucesso
Sem corpo de resposta.
400 Requisição inválida
Mensagens possíveis: Role inválida e Usuário inválido.
{
"message": "Role inválida",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
Mensagens possíveis: Role não encontrada, Usuário não encontrado e Usuário não faz parte desta clínica.
{
"message": "Role não encontrada",
"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
}