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

# Get the monitoring backend's observability capabilities

> The run-list page ceiling, sorts and sort/filter incompatibilities, and the metrics measures and dimensions.

Read from the backend's pure declarations (``max_page_size``, ``list_capability``,
``metrics_capability``) in the run list's wire names; no backend query is issued.



## OpenAPI

````yaml /openapi.json get /api/observability/capabilities
openapi: 3.1.0
info:
  description: >-
    The operator HTTP surface served under /api/*. The platform's core routes.
    Plugin routes are published by each plugin.
  title: tai42-skeleton API
  version: 23.0.0
servers: []
security: []
paths:
  /api/observability/capabilities:
    get:
      tags:
        - observability
      summary: Get the monitoring backend's observability capabilities
      description: >-
        The run-list page ceiling, sorts and sort/filter incompatibilities, and
        the metrics measures and dimensions.


        Read from the backend's pure declarations (``max_page_size``,
        ``list_capability``,

        ``metrics_capability``) in the run list's wire names; no backend query
        is issued.
      operationId: get_api_observability_capabilities
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/ObservabilityCapabilities'
                required:
                  - data
                type: object
          description: Success.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid api key.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ObservabilityCapabilities:
      description: >-
        What the monitoring backend serves, in the run list's wire names.


        ``pageSizeMax`` is the largest run-list page; ``sortKeys`` the run-list
        sort keys it

        serves; ``incompatibleFilters`` maps a sort key to the run-list filter
        params it cannot

        be combined with.
      properties:
        incompatibleFilters:
          additionalProperties:
            items:
              type: string
            type: array
          title: Incompatiblefilters
          type: object
        metrics:
          $ref: '#/components/schemas/ObservabilityMetricsCapabilities'
        pageSizeMax:
          title: Pagesizemax
          type: integer
        sortKeys:
          items:
            enum:
              - createdAt
              - cost
              - latencyMs
              - totalTokens
            type: string
          title: Sortkeys
          type: array
      required:
        - pageSizeMax
        - sortKeys
        - incompatibleFilters
        - metrics
      title: ObservabilityCapabilities
      type: object
    Error:
      properties:
        code:
          description: >-
            Stable machine-readable reason a client keys a dedicated error state
            on, present on refusals that opt in (e.g. a 501 not-configured
            refusal). Optional: absent when the error carries only a
            human-readable message.
          type: string
        error:
          type: string
      required:
        - error
      type: object
    ObservabilityMetricsCapabilities:
      description: The neutral measures and dimensions the backend's metrics query serves.
      properties:
        dimensions:
          items:
            type: string
          title: Dimensions
          type: array
        measures:
          items:
            type: string
          title: Measures
          type: array
      required:
        - measures
        - dimensions
      title: ObservabilityMetricsCapabilities
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````

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