Query parameters

• organization_id array[string]

  Target organization ID(s). Repeat the param to pass multiple values. Optional for all roles except Customer (where it is ignored).

• include string

  Set to descendants together with organization_id to expand each value to its sub-tree.

  Value is descendants.

• page integer

  Page number

  Minimum value is 1. Default value is 1.

• page_size integer

  Items per page

  Minimum value is 1, maximum value is 200. Default value is 20.

• sort_by string

  Values are id, alertname, severity, status, starts_at, ends_at, or created_at. Default value is created_at.

• sort_direction string

  Sort direction. Unlike the shared default of asc, this endpoint defaults to desc so the natural "most recent first" ordering is applied when the caller omits the param.

  Values are asc or desc. Default value is desc.

• from_date string(date-time)

  Lower bound on created_at (inclusive). RFC3339 timestamp.

• to_date string(date-time)

  Upper bound on created_at (exclusive). RFC3339 timestamp. Must be after from_date.

• system_key array[string]

  Filter by one or more system keys. Repeat the param to pass multiple values; results are matched as system_key IN (...).

• alertname array[string]

  Filter by alertname. Supports multiple values.

• severity array[string]

  Filter by severity. Supports multiple values.

  Values are critical, warning, or info.

• status array[string]

  Filter by status. Supports multiple values.

Responses

• 200 application/json

  Paginated alert history

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object
    Hide data attributes Show data attributes object

    • alerts array[object]

      A single resolved or inactive alert stored from an Alertmanager webhook

      Hide alerts attributes Show alerts attributes object

      A single resolved or inactive alert stored from an Alertmanager webhook

      • id integer(int64)

        Auto-incrementing record ID

      • organization_id string

        Tenant the alert belongs to (logto_id of the owning org)

      • system_key string

        System key extracted from alert labels

      • alertname string

        Alert name from labels

      • severity string | null

        Severity from alert labels

      • status string

        Alert status at time of receipt

        Values are resolved or inactive.

      • fingerprint string

        Alertmanager fingerprint for the alert

      • starts_at string(date-time)

        When the alert started firing

      • ends_at string(date-time) | null

        When the alert resolved. Null when the end time is unknown.

      • summary string | null

        Human-readable summary from alert annotations

      • labels object

        All labels from the alert

        Hide labels attribute Show labels attribute object

        • * string Additional properties
      • annotations object

        All annotations from the alert

        Hide annotations attribute Show annotations attribute object

        • * string Additional properties
      • receiver string | null

        Alertmanager receiver that handled this alert

      • created_at string(date-time)

        When the record was created in the database

    • pagination object
      Hide pagination attributes Show pagination attributes object

      • page integer

        Current page number

        Minimum value is 1.

      • page_size integer

        Number of items per page

        Minimum value is 1, maximum value is 200.

      • total_count integer

        Total number of items

        Minimum value is 0.

      • total_pages integer

        Total number of pages

        Minimum value is 0.

      • has_next boolean

        Whether there is a next page

      • has_prev boolean

        Whether there is a previous page

      • next_page integer | null

        Next page number if available

      • prev_page integer | null

        Previous page number if available

      • sort_by string | null

        Field used for sorting

      • sort_direction string | null

        Sort direction

        Values are asc or desc.

• 400 application/json

  Bad request - validation error

  Hide response attributes Show response attributes object

  • code integer

    HTTP error code

  • message string

    Error message

  • data object
    Hide data attributes Show data attributes object

    • type string

      Type of error

      Values are validation_error or external_api_error.

    • errors array[object]
      Hide errors attributes Show errors attributes object

      • key string

        Field name that failed validation

      • message string

        Error code or message

      • value string

        Value that failed validation

    • details

      Additional error details

• 401 application/json

  Unauthorized - invalid or missing token

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null
• 403 application/json

  Forbidden - insufficient permissions

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null