Skip to main content
Alerting & Response/Alert Rules
GETAlertingSince 1.0SynchronousAuth Required

ListAlertEscalationEvents

List escalation events triggered by a specific alert rule

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Query Parameters

Request Inputs

Path Parameters

  • ruleIdStringRequired

    Alert rule identifier to list events for

Query Parameters

  • limitInteger

    Maximum number of recent events to return Maximum number of recent events to return

    Example: 0

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    List of escalation events

    Example: (nested array)

    • eventIdString

      Unique identifier of the escalation event

      Example: esc-event-001

    • ruleIdString

      Alert rule identifier that triggered this event

      Example: rule-abc123

    • alertIdString

      Alert identifier associated with this escalation

      Example: alert-789xyz

    • triggeredAtString

      Timestamp when the escalation was triggered

      Example: 2026-01-15T08:00:00Z

    • matchedKeywordString

      Keyword pattern that triggered the escalation

      Example: OutOfMemory

    • matchCountInteger

      Number of keyword matches within the window

      Example: 5

    • assignedToUserIdString

      User assigned via on-call schedule

      Example: user-001

    • logContextSnippetString

      Snippet of matching log context

      Example: java.lang.OutOfMemoryError: Java heap space

    • statusString

      Current status of the escalation event

      Example: triggered

  • totalInteger

    total equals len(items); this endpoint uses limit (most-recent-N), not pagination.

    Example: 10

  • limitInteger

    Maximum items returned

    Example: 50

  • offsetInteger

    Offset from start of result set

    Example: 20

Endpoint

GET/api/v1/alerting/rules/{ruleId}/logging-escalation/events

/api/v1/alerting/rules/{ruleId}/logging-escalation/events

Operation ID

ListAlertEscalationEvents

Permalink

Request Example

curl -X GET '{host}/api/v1/alerting/rules/{ruleId}/logging-escalation/events' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "items": [
    {}
  ],
  "total": 10,
  "limit": 50,
  "offset": 20
}

Change History

This API has no change history records yet.

View all change history