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

# Summarize Alert

> Kick off an LLM summary of the last N hours of fires for this alert.



## OpenAPI

````yaml post /observability/v1/alerts/{id}/summarize/
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/alerts/{id}/summarize/:
    post:
      tags:
        - observability
      description: |-
        Kick off an LLM summary of the last N hours of fires for this alert.

        Returns a progress_id. Frontend polls `summarize_progress` until status
        is 'completed' or 'error'. Cached for 1 hour keyed on (alert, hours,
        latest fire id) — re-invocations within that window return the same
        progress_id.
      operationId: alerts-summarize-create
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this alert.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AlertDetail'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/AlertDetail'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AlertDetail'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertDetail'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    AlertDetail:
      type: object
      description: Detailed serializer for alert retrieval
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          description: Alert name
          maxLength: 255
        enabled:
          type: boolean
          description: Enable/disable alert
        project:
          type: integer
          description: Project this alert belongs to
        project_name:
          type: string
          readOnly: true
        source_type:
          enum:
            - metric
          type: string
          x-spec-enum-id: 2713692dc60667c9
          description: |-
            Type of data source: metric, duration, call_volume, etc.

            * `metric` - Metric
        source_id:
          type:
            - integer
            - 'null'
          maximum: 2147483647
          minimum: 0
          description: ID of monitored object
        source_object_name:
          type: string
          readOnly: true
        source_object_details:
          type: object
          additionalProperties: {}
          description: Get basic details about the source object
          readOnly: true
        source:
          description: >-
            Source config keyed on `sub_type`. `normal`: {sub_type, filters?}.
            `significant_change`: {sub_type, window_size, filters?}.
            `threshold`: {sub_type, window_size, filters?}. `filters` is an
            optional CallLogQueryFilter expression.
        threshold:
          description: >-
            Threshold config keyed on the source's `sub_type`. `normal`: {}
            (fires on every failing eval). `significant_change`:
            {std_multiplier, ewma_alpha, direction}. `threshold`: {operator
            (gt|lt|outside), value (number | {low, high}), min_breaches}.
        notifications:
          description: >-
            Notification routing. `{slack: {workspace_id, channel_id?}}` to send
            to a specific workspace/channel. Empty fans out to every project
            workspace; empty + no project workspaces means the alert is silent.
        last_triggered_at:
          type:
            - string
            - 'null'
          format: date-time
          readOnly: true
          description: Last trigger timestamp
        trigger_count:
          type: integer
          readOnly: true
          description: Total triggers count
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        last_updated_by:
          type:
            - integer
            - 'null'
          readOnly: true
          description: User who last updated this alert
        last_updated_by_email:
          type: string
          readOnly: true
      required:
        - name
        - project
        - source_type
  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.

````