PATCH Atualizar Roles do Usuário

Define as roles do usuário no Auth0. É uma substituição total: as roles atuais são removidas e as enviadas em rolesIds são atribuídas.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão give_roles.

Substituição, não incremento

Enviar rolesIds vazio (ou omitido) remove todas as roles do usuário. Para saber os IDs de roles disponíveis, use Autenticação → Listar Roles.

---

Endpoint

PATCH https://api-dev.imagemais.com.br/api/users/roles

---

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
id	number	✅	ID do usuário
rolesIds	string[]	❌	IDs das roles (rol_...) a atribuir. Vazio remove todas

---

Requisição

curl -X 'PATCH' \
  'https://api-dev.imagemais.com.br/api/users/roles' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -d '{
  "id": 12,
  "rolesIds": ["rol_QHjvZIV7HAKVw9bT"]
}'

---

Respostas

200 Sucesso

{
  "success": true
}

404 Usuário não encontrado

Retornado quando o usuário não existe ou não tem vínculo com o Auth0 (auth0Id ausente).

{
  "statusCode": 404,
  "message": "Usuário não encontrado"
}