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

# Queryable schema

> The tables, metrics and dimensions that base-wide analysis accepts.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/insights/schema
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-1
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/insights/schema:
    get:
      summary: Queryable schema
      description: >-
        Describes what base-wide analysis accepts: the entities (episodes, open
        items, patterns, actions, objects and profiles), the dimensions and
        filters of each one, the metrics and the minimum group size.


        **Authentication.** Source key with the `analytics` scope, or a Console
        person token with the analysis role (or admin). People with the vendor
        role have no access.
      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: The queryable entities, dimensions and metrics.
      security:
        - sourceKey: []
components:
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````