> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niadra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar papéis

> O que cada papel do Console pode fazer.



## OpenAPI

````yaml openapi/pt/control.json GET /v1/roles
openapi: 3.1.0
info:
  title: API de controle da Niadra
  version: '1'
  description: >-
    Tenants, projetos, fontes, chaves, pessoas, configuração e uso. Nunca recebe
    conteúdo de cliente.
servers:
  - url: https://control.api.niadra.com
security: []
paths:
  /v1/roles:
    get:
      summary: Listar papéis
      description: >-
        Os seis papéis do Console e o que cada um cobre: admin, security,
        integration, review, analysis e vendor. Os papéis se combinam.


        **Autenticação.** Token de pessoa emitido pelo controle (`Authorization:
        Bearer <JWT>`), com o papel que a operação pede.
      operationId: roles_v1_roles_get
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/RoleOut'
                title: Response Roles V1 Roles Get
                type: array
              example:
                - role: admin
                  description: Sources, keys, people, roles and SSO
                - role: security
                  description: >-
                    Reads and receipts, policy and simulation, access cuts,
                    erasure, export, SIEM
                - role: integration
                  description: >-
                    System mappings, task views, pattern and trigger rules,
                    webhooks, configuration assistant
                - role: review
                  description: The sampled review queue, masked by each session's purpose
                - role: analysis
                  description: Measurement, patterns and usage, aggregated or by pseudonym
                - role: vendor
                  description: >-
                    Only the vendor's own sources: their receipts and
                    measurement
          description: Os papéis.
      security:
        - personToken: []
components:
  schemas:
    RoleOut:
      additionalProperties: false
      properties:
        description:
          title: Description
          type: string
        role:
          $ref: '#/components/schemas/Role'
      required:
        - role
        - description
      title: RoleOut
      type: object
    Role:
      description: Papéis do Console, combináveis.
      enum:
        - admin
        - security
        - integration
        - review
        - analysis
        - vendor
      title: Role
      type: string
  securitySchemes:
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````