Alert Rules REST API Guide

List of all alert records during specified time_bucket_start and time_bucket_end for the given alert rule

get

List of all alert records during specified time_bucket_start and time_bucket_end for the given alert rule

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Query parameters

start_timestring · date-timeRequired

requested start time

end_timestring · date-timeRequired

requested end time

limitintegerOptional

Limit for the pagination

offsetintegerOptional

Offset for the pagination

orderingstringOptional

Allows you to order results by any field. For desc order prefix field name with - and provide comman separated values for multiple fields

searchstringOptional

Allows you to search by any field.

Responses

application/json

all ofOptional

Response object for paginated API responses.

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules/{alert_id}/records?start_time=2025-04-23T07%3A35%3A09.782Z&end_time=2025-04-23T07%3A35%3A09.782Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "PAGINATED",
  "data": {
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "alert_rule_id": "123e4567-e89b-12d3-a456-426614174000",
        "alert_rule_revision": 1,
        "warning_threshold": 1,
        "critical_threshold": 1,
        "alert_run_start_time": 1,
        "baseline_time_bucket": 1,
        "baseline_value": 1,
        "severity": "WARNING",
        "alert_time_bucket": 1,
        "alert_value": 1,
        "failure_reason": "text",
        "message": "text",
        "feature_name": "text",
        "alert_record_main_version": 1,
        "alert_record_sub_version": 1,
        "created_at": "2025-04-23T07:35:09.782Z",
        "updated_at": "2025-04-23T07:35:09.782Z"
      }
    ]
  }
}

List latest alert record for each time bucket during specified time_bucket_start and time_bucket_end for the given alert rule

get

List latest alert record for each time bucket during specified time_bucket_start and time_bucket_end for the given alert rule

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Query parameters

start_timestring · date-timeRequired

requested start time

end_timestring · date-timeRequired

requested end time

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules/{alert_id}/record-history?start_time=2025-04-23T07%3A35%3A09.782Z&end_time=2025-04-23T07%3A35%3A09.782Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "items": [
      {
        "time_bucket": 1,
        "alert_count": 1,
        "alert_history_count": 1,
        "latest_record": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "alert_rule_id": "123e4567-e89b-12d3-a456-426614174000",
          "alert_rule_revision": 1,
          "warning_threshold": 1,
          "critical_threshold": 1,
          "alert_run_start_time": 1,
          "baseline_time_bucket": 1,
          "baseline_value": 1,
          "severity": "WARNING",
          "alert_time_bucket": 1,
          "alert_value": 1,
          "failure_reason": "text",
          "message": "text",
          "feature_name": "text",
          "alert_record_main_version": 1,
          "alert_record_sub_version": 1,
          "created_at": "2025-04-23T07:35:09.782Z",
          "updated_at": "2025-04-23T07:35:09.782Z"
        }
      }
    ]
  }
}

List of all alert rule summary in the given time_bucket_start and time_bucket_end

get

List of all alert rule summary in the given time_bucket_start and time_bucket_end

Authorizations

Query parameters

filterstringOptional

Allows you to filter by any field.

searchstringOptional

Allows you to search by any field.

orderingstringOptional

Allows you to order results by any field. For desc order prefix field name with - and provide comman separated values for multiple fields

limitintegerOptional

Limit for the pagination

offsetintegerOptional

Offset for the pagination

start_timestring · date-timeRequired

requested start time

end_timestring · date-timeRequired

requested end time

Responses

application/json

all ofOptional

Response object for paginated API responses.

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules/summary?start_time=2025-04-23T07%3A35%3A09.782Z&end_time=2025-04-23T07%3A35%3A09.782Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "PAGINATED",
  "data": {
    "items": [
      {
        "alert_rule_id": "123e4567-e89b-12d3-a456-426614174000",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "metric": {
          "id": "text",
          "display_name": "text",
          "type": "drift",
          "type_display_name": "Data Drift"
        },
        "is_fiddler_generated": true,
        "priority": "HIGH",
        "compare_to": "raw_value",
        "bin_size": "Hour",
        "condition": "text",
        "alert_record_count": 1,
        "alert_value": 1,
        "feature_names": [
          "text"
        ],
        "threshold_type": "manual",
        "critical_threshold": 1,
        "warning_threshold": 1,
        "enable_notification": true,
        "compare_bin_delta": 1,
        "latest_alert_record_value": 1,
        "latest_alert_time_bucket": 1,
        "latest_alert_feature_name": "text",
        "latest_threshold": 1,
        "latest_alert_record_severity": "WARNING",
        "severity": "WARNING",
        "organization": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "project": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "model": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "version": "text"
        },
        "baseline": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "segment": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "definition": "text"
        },
        "created_at": "2025-04-23T07:35:09.782Z",
        "updated_at": "2025-04-23T07:35:09.782Z",
        "created_by": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "full_name": "text",
          "email": "[e-mail]"
        },
        "updated_by": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "full_name": "text",
          "email": "[e-mail]"
        }
      }
    ]
  }
}

Lists all alert rules configured for a model.

get

Lists all alert rules configured for a model.

Authorizations

Query parameters

limitintegerOptional

Limit for the pagination

offsetintegerOptional

Offset for the pagination

filterstringOptional

Allows you to filter by any field.

orderingstringOptional

Allows you to order results by any field. For desc order prefix field name with - and provide comman separated values for multiple fields

searchstringOptional

Allows you to search by any field.

Responses

application/json

all ofOptional

Response object for paginated API responses.

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "PAGINATED",
  "data": {
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "is_fiddler_generated": true,
        "created_at": "2025-04-23T07:35:09.782Z",
        "updated_at": "2025-04-23T07:35:09.782Z",
        "name": "text",
        "organization": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "metric": {
          "id": "text",
          "display_name": "text",
          "type": "drift",
          "type_display_name": "Data Drift"
        },
        "feature_names": [
          "text"
        ],
        "priority": "HIGH",
        "compare_to": "raw_value",
        "condition": "lesser",
        "compare_bin_delta": 1,
        "evaluation_delay": 1,
        "category": "text",
        "bin_size": "Hour",
        "threshold_type": "manual",
        "auto_threshold_params": {
          "warning_multiplier": 1,
          "critical_multiplier": 1
        },
        "warning_threshold": 1,
        "critical_threshold": 1,
        "enable_notification": true,
        "model": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "version": "text"
        },
        "project": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "baseline": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "segment": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "definition": "text"
        },
        "created_by": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "full_name": "text",
          "email": "[e-mail]"
        },
        "updated_by": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "full_name": "text",
          "email": "[e-mail]"
        }
      }
    ]
  }
}

Creates Alert Rules

post

Creates Alert Rules

Authorizations

Body

all ofOptional

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

post

HTTPcURLJavaScriptPython

POST /v3/alert-rules HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 501

{
  "compare_bin_delta": 1,
  "evaluation_delay": 1,
  "model_id": "123e4567-e89b-12d3-a456-426614174000",
  "segment_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "metric_id": "text",
  "feature_names": [
    "text"
  ],
  "category": "text",
  "baseline_id": "123e4567-e89b-12d3-a456-426614174000",
  "priority": "HIGH",
  "bin_size": "Hour",
  "compare_to": "raw_value",
  "condition": "lesser",
  "threshold_type": "manual",
  "auto_threshold_params": {
    "warning_multiplier": 1,
    "critical_multiplier": 1
  },
  "warning_threshold": 1,
  "critical_threshold": 1
}

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "is_fiddler_generated": true,
    "created_at": "2025-04-23T07:35:09.782Z",
    "updated_at": "2025-04-23T07:35:09.782Z",
    "name": "text",
    "organization": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "metric": {
      "id": "text",
      "display_name": "text",
      "type": "drift",
      "type_display_name": "Data Drift"
    },
    "feature_names": [
      "text"
    ],
    "priority": "HIGH",
    "compare_to": "raw_value",
    "condition": "lesser",
    "compare_bin_delta": 1,
    "evaluation_delay": 1,
    "category": "text",
    "bin_size": "Hour",
    "threshold_type": "manual",
    "auto_threshold_params": {
      "warning_multiplier": 1,
      "critical_multiplier": 1
    },
    "warning_threshold": 1,
    "critical_threshold": 1,
    "enable_notification": true,
    "model": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "version": "text"
    },
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "baseline": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "segment": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "definition": "text"
    },
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    }
  }
}

Returns notification for the given Alert Rule id

get

Returns notification for the given Alert Rule id

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules/{alert_id}/notification HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "emails": [
      "text"
    ],
    "pagerduty_services": [
      "text"
    ],
    "pagerduty_severity": "text",
    "webhooks": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

post

Create Notification for an Alert Rule

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Body

all ofOptional

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

application/json

post

HTTPcURLJavaScriptPython

POST /v3/alert-rules/{alert_id}/notification HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "emails": [
    "text"
  ],
  "pagerduty_services": [
    "text"
  ],
  "pagerduty_severity": "text",
  "webhooks": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "emails": [
      "text"
    ],
    "pagerduty_services": [
      "text"
    ],
    "pagerduty_severity": "text",
    "webhooks": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

Update by id

patch

Update Notification by Alert Rule id

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Body

all ofOptional

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

application/json

patch

HTTPcURLJavaScriptPython

PATCH /v3/alert-rules/{alert_id}/notification HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "emails": [
    "text"
  ],
  "pagerduty_services": [
    "text"
  ],
  "pagerduty_severity": "text",
  "webhooks": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "emails": [
      "text"
    ],
    "pagerduty_services": [
      "text"
    ],
    "pagerduty_severity": "text",
    "webhooks": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

Returns Alert Rule for the given id

get

Returns Alert Rule for the given id

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /v3/alert-rules/{alert_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "is_fiddler_generated": true,
    "created_at": "2025-04-23T07:35:09.782Z",
    "updated_at": "2025-04-23T07:35:09.782Z",
    "name": "text",
    "organization": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "metric": {
      "id": "text",
      "display_name": "text",
      "type": "drift",
      "type_display_name": "Data Drift"
    },
    "feature_names": [
      "text"
    ],
    "priority": "HIGH",
    "compare_to": "raw_value",
    "condition": "lesser",
    "compare_bin_delta": 1,
    "evaluation_delay": 1,
    "category": "text",
    "bin_size": "Hour",
    "threshold_type": "manual",
    "auto_threshold_params": {
      "warning_multiplier": 1,
      "critical_multiplier": 1
    },
    "warning_threshold": 1,
    "critical_threshold": 1,
    "enable_notification": true,
    "model": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "version": "text"
    },
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "baseline": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "segment": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "definition": "text"
    },
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    }
  }
}

Deletes an Alert Rule

delete

Deletes an Alert Rule

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Responses

application/json

application/json

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v3/alert-rules/{alert_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update by id

patch

Update Alert Rule by id

Authorizations

Path parameters

alert_idstring · uuidRequired

alert id path parameter

Body

all ofOptional

Responses

application/json

all ofOptional

Response object for standard API responses.

application/json

application/json

application/json

patch

HTTPcURLJavaScriptPython

PATCH /v3/alert-rules/{alert_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 199

{
  "name": "text",
  "warning_threshold": 1,
  "critical_threshold": 1,
  "evaluation_delay": 1,
  "priority": "HIGH",
  "enable_notification": true,
  "auto_threshold_params": {
    "warning_multiplier": 1,
    "critical_multiplier": 1
  }
}

{
  "api_version": "2.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "is_fiddler_generated": true,
    "created_at": "2025-04-23T07:35:09.782Z",
    "updated_at": "2025-04-23T07:35:09.782Z",
    "name": "text",
    "organization": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "metric": {
      "id": "text",
      "display_name": "text",
      "type": "drift",
      "type_display_name": "Data Drift"
    },
    "feature_names": [
      "text"
    ],
    "priority": "HIGH",
    "compare_to": "raw_value",
    "condition": "lesser",
    "compare_bin_delta": 1,
    "evaluation_delay": 1,
    "category": "text",
    "bin_size": "Hour",
    "threshold_type": "manual",
    "auto_threshold_params": {
      "warning_multiplier": 1,
      "critical_multiplier": 1
    },
    "warning_threshold": 1,
    "critical_threshold": 1,
    "enable_notification": true,
    "model": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "version": "text"
    },
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "baseline": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text"
    },
    "segment": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "definition": "text"
    },
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[e-mail]"
    }
  }
}