GET Listar Permissões de um Role

Lista as permissões atribuídas a um role no Auth0.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão update_roles.

Sem paginação

A rota pagina internamente pelas páginas do Auth0 e retorna a lista completa de uma vez.

---

Endpoint

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

---

Parâmetros de Rota

Nome	Tipo	Obrigatório	Descrição
id	string	✅	ID do role no Auth0

---

Requisição

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

---

Respostas

200 Sucesso

[
  {
    "permission_name": "read_budgets",
    "description": "Ler orçamentos"
  },
  {
    "permission_name": "create_budgets",
    "description": "Criar orçamentos"
  }
]

404 Role não existe

Erro cru do SDK do Auth0

Diferente das outras rotas da API, este erro não passa pelo formato padrão do Nest — é o objeto de erro do SDK do Auth0 serializado como veio.

{
  "statusCode": 404,
  "message": "NotFoundError\nStatus code: 404\nBody: {\n  \"statusCode\": 404,\n  \"error\": \"Not Found\",\n  \"message\": \"The role does not exist.\"\n}"
}

400 ID com formato inválido

{
  "statusCode": 400,
  "message": "BadRequestError\nStatus code: 400\nBody: {\n  \"statusCode\": 400,\n  \"error\": \"Bad Request\",\n  \"message\": \"Path validation error: 'Object didn't pass validation for format role-id: {id}' on property id (ID of the role to list granted permissions).\",\n  \"errorCode\": \"invalid_uri\"\n}"
}