---
title: "Listagem de papéis por aplicação"
method: GET
path: "/auth/api/v1/application/{application}/access-roles"
---

# Listagem de papéis por aplicação

`GET /auth/api/v1/application/{application}/access-roles`

## Request

- Base URL: `https://apigw.nuvidio.com`
- URL: `https://apigw.nuvidio.com/auth/api/v1/application/{application}/access-roles`
- Auth: OAuth 2

Retorna todas as roles com base na aplicação informada

## Path parameters

- `application` 'agreement_dashboard' | 'agreement_manager', required

## Response `200`

ok

- object
  - `roles` object[], required: lista de roles por aplicação
    - `id` string, required: identificador
    - `name` string, required: nome do papel (role)
    - `modules` object[], required: lista de módulos e permissões por role
      - `id` string, required: identificador
      - `name` string, required: nome do módulo
      - `key` string, required: identificador amigável
      - `read` boolean, required: acesso de leitura
      - `export` boolean, required: acesso para relatórios
      - `write` boolean, required: acesso para criação e edição
      - `delete` boolean, required: acesso para deletar e desabilitar
      - `none` boolean, required: true quando não possui acesso ao módulo
  - `count` integer, required: total encontrado

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2.md) - [All operations](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/revisions/c488e657f07b?raw)