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

# Esquema consultável

> As tabelas, métricas e dimensões que a análise da base aceita.



## OpenAPI

````yaml openapi/pt/cell.json GET /v1/insights/schema
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-1
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/insights/schema:
    get:
      summary: Esquema consultável
      description: >-
        Descreve o que a análise da base aceita: as entidades (episódios,
        pendências, padrões, ações, objetos e perfis), as dimensões e os filtros
        de cada uma, as métricas e o tamanho mínimo de grupo.


        **Autenticação.** Chave de fonte com o escopo `analytics`, ou token de
        pessoa do Console com o papel analysis (ou admin). Pessoas do papel
        vendor não acessam.
      operationId: describe_schema_v1_insights_schema_get
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Describe Schema V1 Insights Schema Get
                type: object
              example:
                entities:
                  episodes:
                    dimensions:
                      - intent
                      - category
                      - normalized_category
                      - outcome
                      - channel
                      - source_id
                      - initiated_by
                      - sentiment_band
                    metrics:
                      - count
                      - profiles
                      - avg_sentiment
                  open_items:
                    dimensions:
                      - owner
                      - status
                      - object_type
                      - expected_operation
                      - age_band
                    metrics:
                      - count
                      - profiles
                min_group_size: 10
          description: As entidades, dimensões e métricas consultáveis.
      security:
        - sourceKey: []
components:
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````