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

# Describe analytics

> List the analytics events, their fields, filter operators, time buckets, and query limits. Query fields live inside each event's envelope fields: every event also carries actor, surface, user_id, and api_key_id.



## OpenAPI

````yaml https://api.uselemma.ai/openapi.json get /projects/{project_id}/analytics
openapi: 3.1.0
info:
  title: Lemma Platform API
  description: Lemma Platform HTTP API for AI observability and workspace operations.
  version: 0.1.0
servers:
  - url: https://api.uselemma.ai
    description: Lemma production API
security:
  - bearerAuth: []
paths:
  /projects/{project_id}/analytics:
    get:
      tags:
        - Analytics
      summary: Describe analytics
      description: >-
        List the analytics events, their fields, filter operators, time buckets,
        and query limits. Query fields live inside each event's envelope fields:
        every event also carries actor, surface, user_id, and api_key_id.
      operationId: describe_project_analytics
      parameters:
        - name: project_id
          in: path
          required: true
          description: Project ID.
          schema:
            type: string
      responses:
        '200':
          description: Analytics catalog
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          enum:
                            - artifact.iterated
                            - generation.completed
                            - insight.activated
                            - insight.created
                            - insight.deleted
                            - insight.merged
                            - insight.review_completed
                            - insight.revised
                            - issue.created
                            - issue.dismissed
                            - issue.flagged
                            - issue.insight_assessed
                            - issue.insight_moved
                            - issue.occurrence_recorded
                            - issue.reopened
                            - issue.resolved
                            - issue.review_started
                            - issue.slack_sent
                            - issue.unflagged
                            - span.errored
                            - tool.called
                            - trace.processed
                        dimensions:
                          type: array
                          items:
                            type: object
                            properties:
                              field:
                                type: string
                              type:
                                type: string
                            required:
                              - field
                              - type
                            additionalProperties: false
                        measures:
                          type: array
                          items:
                            type: object
                            properties:
                              field:
                                type: string
                              type:
                                type: string
                              aggs:
                                type: array
                                items:
                                  type: string
                            required:
                              - field
                              - type
                              - aggs
                            additionalProperties: false
                        cost_measures:
                          type: array
                          items:
                            type: string
                            enum:
                              - trace_cost
                              - generation_cost
                      required:
                        - name
                        - dimensions
                        - measures
                        - cost_measures
                      additionalProperties: false
                  filter_ops:
                    type: array
                    items:
                      type: string
                      enum:
                        - eq
                        - neq
                        - gt
                        - gte
                        - lt
                        - lte
                        - in
                        - is_null
                        - is_not_null
                  buckets:
                    type: array
                    items:
                      type: string
                      enum:
                        - minute
                        - hour
                        - day
                        - week
                        - month
                  limits:
                    type: object
                    properties:
                      max_group_by:
                        type: number
                        const: 3
                      max_measures:
                        type: number
                        const: 8
                      max_rows:
                        type: number
                        const: 500
                      max_window_days:
                        type: number
                        const: 90
                      max_in_values:
                        type: number
                        const: 20
                      max_order_by:
                        type: number
                        const: 2
                      max_filters:
                        type: number
                        const: 12
                    required:
                      - max_group_by
                      - max_measures
                      - max_rows
                      - max_window_days
                      - max_in_values
                      - max_order_by
                      - max_filters
                    additionalProperties: false
                required:
                  - events
                  - filter_ops
                  - buckets
                  - limits
                additionalProperties: false
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                  retryable:
                    type: boolean
                  retry_after_seconds:
                    type: number
                    minimum: 0
                required:
                  - detail
                  - code
                  - retryable
                additionalProperties: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                  retryable:
                    type: boolean
                  retry_after_seconds:
                    type: number
                    minimum: 0
                required:
                  - detail
                  - code
                  - retryable
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.