Skip to main content

GET Buscar Roles do Usuário

Retorna os IDs das roles atribuídas ao usuário no provedor de identidade, dentro da organização do token.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão give_roles.

Endpoint​

GET https://api-dev.imagemais.com.br/api/users/{id}/roles

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID interno do usuário

Requisição​

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/users/12/roles' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

Array com os IDs (rol_...) das roles do usuário no provedor de identidade.

["rol_QHjvZIV7HAKVw9bT", "rol_AbCdEfGhIjKlMnOp"]

Se o usuário não tiver vínculo com o provedor de identidade (auth0Id ausente) ou não tiver nenhuma role, retorna [].

404 Usuário não encontrado​

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