> ## 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.

# List roles

> What each Console role can do.



## OpenAPI

````yaml openapi/en/control.json GET /v1/roles
openapi: 3.1.0
info:
  title: Niadra control API
  version: '1'
  description: >-
    Tenants, projects, sources, keys, people, configuration and usage. It never
    receives customer content.
servers:
  - url: https://control.api.niadra.com
security: []
paths:
  /v1/roles:
    get:
      summary: List roles
      description: >-
        The six Console roles and what each one covers: admin, security,
        integration, review, analysis and vendor. Roles combine.


        **Authentication.** Person token issued by the control plane
        (`Authorization: Bearer <JWT>`), with the role the operation needs.
      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: The roles.
      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: Console roles, combinable.
      enum:
        - admin
        - security
        - integration
        - review
        - analysis
        - vendor
      title: Role
      type: string
  securitySchemes:
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````