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

# List Metric Failure Mode Insight Categories

> Return the persistent failure categories for a project (optionally one metric), each with a call count and example call ids. Filter by `date_from` / `date_to` (ISO datetimes for an exact window, or bare dates for whole-day bounds) to count only assignments in that range; results are sorted by count descending.



## OpenAPI

````yaml get /observability/v1/metric-failure-mode-insights/categories/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /observability/v1/metric-failure-mode-insights/categories/:
    get:
      tags:
        - observability
      summary: List accumulating failure categories for a metric
      description: >-
        Return the persistent failure categories for a project (optionally one
        metric), each with a call count and example call ids. Filter by
        `date_from` / `date_to` (ISO datetimes for an exact window, or bare
        dates for whole-day bounds) to count only assignments in that range;
        results are sorted by count descending.
      operationId: metric-failure-mode-insights-categories-retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetricFailureModeInsight'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    MetricFailureModeInsight:
      type: object
      description: Insight row exposed to the Observability → Insights UI.
      properties:
        id:
          type: integer
          readOnly: true
        project:
          type: integer
          readOnly: true
        metric:
          type:
            - integer
            - 'null'
          readOnly: true
        predefined_metric:
          type:
            - integer
            - 'null'
          readOnly: true
        metric_name:
          type: string
          readOnly: true
        is_triage:
          type: boolean
          description: |-
            Derived live from the metric's current `triage_enabled` + rubric
            membership (not persisted) — the FE renders the triage section only
            when this is true.
          readOnly: true
        window_start:
          type: string
          format: date-time
          readOnly: true
        window_end:
          type: string
          format: date-time
          readOnly: true
        num_calls_analyzed:
          type: integer
          readOnly: true
        total_failures_in_window:
          type: integer
          readOnly: true
        status:
          enum:
            - pending
            - running
            - succeeded
            - failed
            - skipped_no_failures
          type: string
          description: |-
            * `pending` - Pending
            * `running` - Running
            * `succeeded` - Succeeded
            * `failed` - Failed
            * `skipped_no_failures` - Skipped No Failures
          x-spec-enum-id: 7052652d8ca01a2a
          readOnly: true
        headline:
          type: string
          readOnly: true
        overall_status_emoji:
          type: string
          readOnly: true
        failure_modes:
          readOnly: true
        error_message:
          type: string
          readOnly: true
        duration_seconds:
          type:
            - number
            - 'null'
          format: double
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````