Retrieve Scheduled Alert

GEThttps://api.confident-ai.com/v1/scheduled-alerts/{scheduledAlertId}

Retrieves a single scheduled alert with its threshold, filters, and schedule state.

GET/v1/scheduled-alerts/{scheduledAlertId}

curl -X GET "https://api.confident-ai.com/v1/scheduled-alerts/{scheduledAlertId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "scheduledAlert": {
      "id": "SCHEDULED-ALERT-ID",
      "name": "Trace error rate spike",
      "description": "Errors above 5% over the last hour",
      "dataModel": "TRACE",
      "aggregation": "ERROR_RATE",
      "filters": {
        "operator": "OR",
        "groups": []
      },
      "thresholdSettings": {
        "value": 0.05,
        "direction": "above"
      },
      "severity": "ERROR",
      "scheduleSettings": {
        "recurrence": "INTERVAL",
        "repeatEvery": 1,
        "repeatUnit": "HOUR",
        "startAt": null,
        "endAt": null,
        "maxRuns": null,
        "runCount": 12,
        "lastRunAt": "2026-08-16T09:00:00.000Z",
        "enabled": true
      }
    }
  },
  "link": "https://app.confident-ai.com/project/<PROJECT-ID>/monitors"
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

scheduledAlertIdstringRequired
The unique identifier of the scheduled alert.

Response

successboolean
Indicates if the request was successful.
dataobject
Show 1 propertyHide 1 property
- scheduledAlertobject
  Show 16 propertiesHide 16 properties
  - idstring
    The unique identifier of the scheduled alert.
  - namestring
    The name of the scheduled alert.
  - dataModelenum
    What kind of item the alert measures over.
    Show 3 enum valuesHide 3 enum values
    TRACE
    SPAN
    THREAD
  - aggregationstring
    What the alert measures, such as ERROR_RATE or P90_LATENCY.
  - thresholdSettingsobject
    When the alert fires. Latency is compared in seconds, cost in USD, and rates such as ERROR_RATE as fractions between 0 and 1.
    Show 2 propertiesHide 2 properties
    valuenumber
    The number the measured value is compared against.
    directionenum
    Whether the alert fires when the measured value rises above the threshold or falls below it.
    Show 2 enum valuesHide 2 enum values
    above
    below
  - scheduleSettingsobject
    The alert's schedule and its run history.
    Show 9 propertiesHide 9 properties
    recurrenceenum
    Whether the alert runs repeatedly or a single time.
    Show 2 enum valuesHide 2 enum values
    ONCE
    INTERVAL
    repeatEveryinteger
    How many repeatUnits between runs.
    repeatUnitenum
    The unit paired with repeatEvery.
    Show 5 enum valuesHide 5 enum values
    MINUTE
    HOUR
    DAY
    WEEK
    MONTH
    startAtstring
    When the schedule starts running.
    endAtstring
    When the schedule stops running.
    maxRunsinteger
    The number of triggers after which the alert stops.
    runCountinteger
    How many times the alert has triggered so far.
    lastRunAtstring
    When the alert last ran. Null until its first run.
    enabledboolean
    Whether the schedule is currently running.
  - descriptionstring
    What the alert means and what to do about it. Included in the notification.
  - filtersobject
    A set of filter groups combined by a top-level operator.
    Show 2 propertiesHide 2 properties
    operatorenum
    How filters or groups are combined.
    Show 2 enum valuesHide 2 enum values
    AND
    OR
    groupslist of objects
    The filter groups.
    Show 2 propertiesHide 2 properties
    operatorenum
    How filters or groups are combined.
    Show 2 enum valuesHide 2 enum values
    AND
    OR
    filterslist of objects
    The filter rows in this group.
    Show 4 propertiesHide 4 properties
    categorystring
    The property a filter row matches on (e.g. "Name", "User Id", "Model", "Metadata"). The set of valid values depends on the line's dataModel.
    conditionenum
    The comparison a filter row applies. Valid conditions depend on the category.
    Show 18 enum valuesHide 18 enum values
    Is
    Is not
    Is equal to
    Does not equal
    Is less than
    Is equal or less than
    Is greater than
    Is equal or greater than
    Has
    Has not
    Contains
    Contains only
    Does not contain
    Has increased by more than
    Has increased by less than
    Has decreased by more than
    Has decreased by less than
    Has changed from
    valuestring | number | list of strings
    The value to match against.
    keystring
    The property key. Auto-populated from category when omitted; required for Metadata, Metric, and Classifier filters.
  - severityenum
    How urgent the alert is. Also decides which of the project's integrations receive it. Defaults to WARNING.
    Show 4 enum valuesHide 4 enum values
    CRITICAL
    ERROR
    WARNING
    INFO
  - recurrenceenum
    Whether the alert runs repeatedly or a single time. Defaults to INTERVAL.
    Show 2 enum valuesHide 2 enum values
    ONCE
    INTERVAL
  - repeatEveryinteger
    How many repeatUnits between runs. Required for INTERVAL.
  - repeatUnitenum
    The unit paired with repeatEvery. Together they also set the measurement window, so an alert repeating every hour compares the last hour of data. A ONCE alert measures the last 24 hours.
    Show 5 enum valuesHide 5 enum values
    MINUTE
    HOUR
    DAY
    WEEK
    MONTH
  - startAtstring
    When the schedule starts running. Starts immediately when omitted.
  - maxRunsinteger
    Stop the alert after it has triggered this many times.
  - endAtstring
    When the schedule stops running.
  - enabledboolean
    Whether the schedule runs. Defaults to true on create. An alert whose run limit or end date has passed cannot be re-enabled.
linkstring
A link to the monitors page.

Built byConfident AI