Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fdeveloper-portal%2Fapis%2Fdata-management%2Fslo-management-alerts-api.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fdeveloper-portal%2Fapis%2Fdata-management%2Fslo-management-alerts-api.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.) # SLO management API Use the **SLO Management API** to manage your [SLOs (service level objectives)](https://docs-docusaurus.kinsta.page/user-guides/slos/introduction/.md) programmatically. You can create, retrieve, update, and delete SLOs and their associated alerts. This API is ideal for teams that prefer programmatic access to SLO management. ## Prerequisites[​](#prerequisites "Direct link to Prerequisites") Before using the SLO Management API, ensure the following prerequisites are met: * You must have a personal or team [API key](https://docs-docusaurus.kinsta.page/user-guides/account-management/api-keys/api-keys/.md). We recommend using the **SLO** permission preset, which is automatically updated with the necessary scopes. Alternatively, you can manually assign individual permissions as needed: | **Action** | **Description** | | ------------------------------ | ------------------------------- | | `SLO-MGMT.ALERTS:READCONFIG` | View SLO Based Alert Settings | | `SLO-MGMT.ALERTS:UPDATECONFIG` | Manage SLO Based Alert Settings | | `SLO-MGMT.SLO:READCONFIG` | View SLO Settings | | `SLO-MGMT.SLO:UPDATECONFIG` | Manage SLO Settings | To assign the **SLO** permission preset to an API key, navigate to **API Keys** and click on **+ PERSONAL KEY** or **+ TEAM KEY**. Then, select the **SLO** permission preset from the **Role Presets** dropdown. [![SLO Permission Preset](/assets/images/slo_permissions-7835d994a8625a64ea316c4ac2ec5f22.webp)](https://docs-docusaurus.kinsta.page/assets/images/slo_permissions-7835d994a8625a64ea316c4ac2ec5f22.webp) ## Authentication[​](#authentication "Direct link to Authentication") Include your API key in the `Authorization` header: **Example**: ``` grpcurl -H "Authorization: Bearer " ``` ``` curl -H "Authorization: Bearer " ``` ## API specification[​](#api-specification "Direct link to API specification") This section provides example requests and responses for the **Create**, **List**, **Delete**, and **Edit** SLO methods and **Create** and **List** SLO alert methods, using both **curl** (HTTP) and **grpcurl** (gRPC) formats. Visit our [SLO Management OpenAPI documentation](https://docs-docusaurus.kinsta.page/api-reference/v5/slos-service/create-slo/.md) to see the full specification of the HTTP API methods and parameters. ### Create SLO[​](#create-slo "Direct link to Create SLO") Creates a new SLO for the specified service. Use it to define the parameters of the SLO, including target percentage, filters, and service level indicators (SLIs). Note * In SLI expressions, an aggregation function (such as `sum`, `avg`, or `count`) is required. This ensures that SLOs evaluate meaningful permutations based on the specified label dimensions. * When querying SLO metrics, you usually don’t need to add a range selector; the query uses an appropriate time window automatically. If you do include a range selector (e.g., \[1h]) for a specific need, that exact time window will be used and not overridden. Add a range **only** when you require a custom time window. #### **Event-Based SLO**[​](#event-based-slo "Direct link to event-based-slo") Learn more about Event-Based SLOs in our documentation [here](https://docs-docusaurus.kinsta.page/user-guides/slos/create/.md). * HTTP * gRPC **Example request:** ``` curl -X POST https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "sre-team@example.com", "labels": { "entityIdentifier": "foo bar" }, "targetThresholdPercentage": 99.95, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(rate(http_requests_total{status=~\"2..\"})) by(service_name)" }, "totalEvents": { "query": "sum(rate(http_requests_total)) by(service_name)" } } }' ``` **Example response:** ``` { "slo": { "id": "", "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "sre-team@example.com", "labels": { "entityIdentifier": "foo bar" }, "revision": { "revision": 1, "updateTime": "2024-03-20T10:00:00Z" }, "grouping": { "labels": ["service_name"] }, "createTime": "2024-03-20T10:00:00Z", "updateTime": "2024-03-20T10:00:00Z", "targetThresholdPercentage": 99.95, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(rate(http_requests_total{status=~\"2..\"})) by(service_name)" }, "totalEvents": { "query": "sum(rate(http_requests_total)) by(service_name)" } } } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/CreateSlo <", "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "sre-team@example.com", "revision": { "revision": 1, "update_time": "2024-03-20T10:00:00Z" }, "grouping": { "labels": ["service_name"] }, "create_time": "2024-03-20T10:00:00Z", "update_time": "2024-03-20T10:00:00Z", "target_threshold_percentage": 99.95, "window": { "slo_time_frame": "SLO_TIME_FRAME_28_DAYS" }, "request_based_metric_sli": { "good_events": { "query": "sum(rate(http_requests_total{status=~\"2..\"})) by(service_name)" }, "total_events": { "query": "sum(rate(http_requests_total)) by(service_name)" } } } } ``` #### **Time Window SLO**[​](#time-window-slo "Direct link to time-window-slo") Learn more about time window SLOs in our documentation [here](https://docs-docusaurus.kinsta.page/user-guides/slos/create/.md). * HTTP * gRPC **Example request:** ``` curl -X POST https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "sre-team@example.com", "targetThresholdPercentage": 99.95, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "windowBasedMetricSli": { "query": { "query": "avg(product_latency_by_country) by (country) < 500" }, "window": "WINDOW_SLO_WINDOW_1_MINUTE", "comparisonOperator": "COMPARISON_OPERATOR_GREATER_THAN", "threshold": 65 } }' ``` **Example response:** ``` { "slo": { "id": "", "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "bot@coralogix.com", "labels": {}, "revision": { "revision": 1, "updateTime": "2025-08-06T09:25:30.980Z" }, "grouping": { "labels": [ "country" ] }, "createTime": "2025-08-06T09:25:30.980Z", "updateTime": "2025-08-06T09:25:31.010Z", "targetThresholdPercentage": 99.95, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "windowBasedMetricSli": { "query": { "query": "avg(product_latency_by_country) by (country) < 500" }, "window": "WINDOW_SLO_WINDOW_1_MINUTE", "comparisonOperator": "COMPARISON_OPERATOR_GREATER_THAN", "threshold": 65 } } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/CreateSlo <", "name": "API Availability SLO", "description": "Monitors the availability of our critical API endpoints", "creator": "sre-team@example.com", "revision": { "revision": 1, "update_time": "2024-03-20T10:00:00Z" }, "grouping": { "labels": ["service_name"] }, "create_time": "2024-03-20T10:00:00Z", "update_time": "2024-03-20T10:00:00Z", "target_threshold_percentage": 99.95, "window": { "slo_time_frame": "SLO_TIME_FRAME_28_DAYS" }, "window_based_metric_sli": { "query": { "query": "histogram_quantile(0.95, sum(increase(duration_ms_bucket)) by (service_name, le))" }, "window": "WINDOW_SLO_WINDOW_1_MINUTE", "comparison_operator": "COMPARISON_OPERATOR_GREATER_THAN", "threshold": 65 } } } ``` #### **APM SLO**[​](#apm-slo "Direct link to apm-slo") [APM SLOs](https://docs-docusaurus.kinsta.page/user-guides/slos/create/.md) are managed through the dedicated `com.coralogixapis.slo.v1.ApmSloService`. The SLO type is fixed to **Errors** or **Latency**, and Coralogix generates the underlying PromQL queries from your inputs (services, filters, grouping keys, threshold, time frame). The `metric_source` field selects which APM metric pipeline backs the SLO: * `APM_SOURCE_SPAN_METRICS` — OpenTelemetry span metrics (`calls_total`, `duration_ms_bucket`, etc.). * `APM_SOURCE_E2M` — Coralogix Events-to-Metrics (`cx_service_catalog_duration_update_cx_*`). Note The HTTP API for APM SLOs is exposed at `/4/v1/slo/apm-slos` through the OpenAPI gateway. HTTP requests use camelCase field names (for example, `targetThresholdPercentage`); gRPC requests use snake\_case (`target_threshold_percentage`). See the [SLO Management OpenAPI documentation](https://docs-docusaurus.kinsta.page/api-reference/v5/slos-service/create-slo/.md) for the full HTTP specification. ##### Error APM SLO[​](#error-apm-slo "Direct link to Error APM SLO") Tracks the percentage of requests completed without errors. Use the `errorConfig` (HTTP) / `error_config` (gRPC) SLI type. * HTTP * gRPC **Example request:** ``` curl -X POST https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/apm-slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "apmSlo": { "name": "Checkout Service Error Rate", "description": "Error rate monitoring for the checkout API", "targetThresholdPercentage": 99.5, "window": { "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS" }, "apmSli": { "services": ["checkout-service"], "filters": [{ "key": "environment", "values": ["production"] }], "groupingKeys": ["environment", "region"], "sliType": { "errorConfig": {} } }, "labels": { "team": "checkout" } }, "metricSource": "APM_SOURCE_SPAN_METRICS" }' ``` **Example response:** ``` { "slo": { "slo": { "id": "", "name": "Checkout Service Error Rate", "description": "Error rate monitoring for the checkout API", "targetThresholdPercentage": 99.5, "productType": "SLO_PRODUCT_TYPE_APM", "window": { "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS" }, "createTime": "2026-04-29T10:28:00Z", "updateTime": "2026-04-29T10:28:00Z" } } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.ApmSloService/CreateApmSlo <", "name": "Checkout Service Error Rate", "description": "Error rate monitoring for the checkout API", "target_threshold_percentage": 99.5, "product_type": "SLO_PRODUCT_TYPE_APM", "window": { "slo_time_frame": "SLO_TIME_FRAME_28_DAYS" }, "create_time": "2026-04-29T10:28:00Z", "update_time": "2026-04-29T10:28:00Z" } } } ``` ##### Latency APM SLO[​](#latency-apm-slo "Direct link to Latency APM SLO") Tracks the percentage of requests that meet a latency threshold. Use the `latencyConfig` (HTTP) / `latency_config` (gRPC) SLI type with a `quantile` (for example, P95, P99) or `average` aggregation. * HTTP * gRPC **Example request:** ``` curl -X POST https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/apm-slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "apmSlo": { "name": "API Gateway P95 Latency", "targetThresholdPercentage": 99.0, "window": { "sloTimeFrame": "SLO_TIME_FRAME_7_DAYS" }, "apmSli": { "services": ["api-gateway"], "sliType": { "latencyConfig": { "timeWindow": "WINDOW_SLO_WINDOW_5_MINUTES", "threshold": 200.0, "quantile": { "percentile": 0.95 } } } } }, "metricSource": "APM_SOURCE_SPAN_METRICS" }' ``` **Example response:** ``` { "slo": { "slo": { "id": "", "name": "API Gateway P95 Latency", "targetThresholdPercentage": 99.0, "productType": "SLO_PRODUCT_TYPE_APM", "window": { "sloTimeFrame": "SLO_TIME_FRAME_7_DAYS" }, "createTime": "2026-04-29T10:28:00Z", "updateTime": "2026-04-29T10:28:00Z" } } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.ApmSloService/CreateApmSlo <", "name": "API Gateway P95 Latency", "target_threshold_percentage": 99.0, "product_type": "SLO_PRODUCT_TYPE_APM", "window": { "slo_time_frame": "SLO_TIME_FRAME_7_DAYS" }, "create_time": "2026-04-29T10:28:00Z", "update_time": "2026-04-29T10:28:00Z" } } } ``` ##### APM SLO field reference[​](#apm-slo-field-reference "Direct link to APM SLO field reference") | Field | Type | Description | | ------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------ | | `apm_slo.name` | string | SLO name. | | `apm_slo.description` | string | Optional description. | | `apm_slo.target_threshold_percentage` | float | Target success rate (for example, 99.5). | | `apm_slo.window.slo_time_frame` | enum | Rolling evaluation window: `SLO_TIME_FRAME_7_DAYS`, `_14_DAYS`, `_21_DAYS`, or `_28_DAYS`. | | `apm_slo.apm_sli.services` | string\[] | Service names monitored by the SLO. Currently one service per SLO. | | `apm_slo.apm_sli.filters` | object\[] | Optional label filters (`key`, `values`). | | `apm_slo.apm_sli.grouping_keys` | string\[] | Labels to break down results by. | | `apm_slo.apm_sli.sli_type.error_config` | object | Empty object selects the error SLI type. | | `apm_slo.apm_sli.sli_type.latency_config.time_window` | enum | `WINDOW_SLO_WINDOW_1_MINUTE` or `WINDOW_SLO_WINDOW_5_MINUTES`. | | `apm_slo.apm_sli.sli_type.latency_config.threshold` | float | Latency threshold in milliseconds. | | `apm_slo.apm_sli.sli_type.latency_config.quantile.percentile` | float | Percentile between 0 and 1 (for example, `0.95` for P95). | | `apm_slo.apm_sli.sli_type.latency_config.average` | object | Empty object selects average aggregation instead of `quantile`. | | `apm_slo.labels` | map | Optional metadata labels. | | `metric_source` | enum | `APM_SOURCE_SPAN_METRICS` or `APM_SOURCE_E2M`. | ### List SLOs[​](#list-slos "Direct link to List SLOs") Retrieves all SLOs from the service catalog. You can apply optional filters to refine the SLO data returned. To list only APM SLOs, filter by `product_type` set to `SLO_PRODUCT_TYPE_APM`. The response includes the full `apm_source_config` for each APM SLO. * HTTP * gRPC **Example request** ``` curl -X GET https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/slos \ -H "Authorization: Bearer " ``` **Example response:** ``` { "slos": [ { "id": "", "name": "Frontend service error rate", "description": "frontend error", "creator": "sre-team@example.com", "labels": {}, "revision": { "revision": 1, "updateTime": "2025-06-15T19:37:58.437Z" }, "grouping": { "labels": [] }, "createTime": "2025-06-15T19:37:58.437Z", "updateTime": "2025-06-15T19:37:58.628Z", "targetThresholdPercentage": 99, "sloTimeFrame": "SLO_TIME_FRAME_7_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(calls_total_total{status_code!=\"STATUS_CODE_ERROR\", service_name=\"frontend\"})" }, "totalEvents": { "query": "sum(calls_total_total{service_name=\"frontend\"})" } } }, { "id": "", "name": "SLO Service Errors", "description": "This SLO tracks error events in requests, internal operations or outgoing calls.", "creator": "sre-team@example.com", "labels": { "Metric": "Error" }, "revision": { "revision": 1, "updateTime": "2025-06-17T18:00:42.454Z" }, "grouping": { "labels": [ "k8s_node_name", "service_name" ] }, "createTime": "2025-06-17T18:00:42.454Z", "updateTime": "2025-06-17T18:00:42.469Z", "targetThresholdPercentage": 94, "sloTimeFrame": "SLO_TIME_FRAME_7_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(calls_total_total{status_code!='STATUS_CODE_ERROR'}) by (service_name, k8s_node_name)" }, "totalEvents": { "query": "sum(calls_total_total) by (service_name, k8s_node_name)" } } } ] } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/ListSlos <", "name": "API Latency SLO", "description": "Monitors the latency of our critical API endpoints", "creator": "sre-team@example.com", "labels": { "environment": "staging", "service": "api-gateway", "team": "platform" }, "revision": { "revision": 1, "update_time": "2024-03-20T11:00:00Z" }, "grouping": { "labels": ["environment", "service"] }, "create_time": "2024-03-20T11:00:00Z", "update_time": "2024-03-20T11:00:00Z", "target_threshold_percentage": 99.9, "window": { "slo_time_frame": "SLO_TIME_FRAME_28_DAYS" }, "request_based_metric_sli": { "good_events": { "query": "sum(rate(http_requests_total{status=~\"2..\"})) by(service_name)" }, "total_events": { "query": "sum(rate(http_requests_total)) by(service_name)" } } } ] } ``` **Example request — list APM SLOs only**: Filter by `product_type` to return only APM SLOs. The response includes the full `apm_source_config` for each result. ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/ListSlos < \ -H "Authorization: Bearer " ``` Example response: ``` { "effectedSloAlertIds": [ "" ] } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/DeleteSlo <" } EOF ``` **Example response:** ``` { "affected_slo_alert_ids": ["", ""] } ``` ## Edit SLO[​](#edit-slo "Direct link to Edit SLO") Edit an SLO by its ID. The response includes all associated alerts and identifies which alerts will become invalid due to the SLO update. Any alerts impacted by the changes must be either removed or updated to align with the new SLO configuration. Note The edit operation also validates affected alerts and returns a list of invalidated SLO alerts. The request will not succeed until all invalid alerts are either automatically updated or manually resolved by the user. Note Custom SLOs use `SlosService/ReplaceSlo`. APM SLOs use `ApmSloService/ReplaceApmSlo` with the same `apm_slo` payload as `CreateApmSlo`, plus the SLO `id`. Both endpoints return `effected_slo_alert_ids` for any alerts impacted by the change. ### Edit APM SLO[​](#edit-apm-slo "Direct link to Edit APM SLO") * HTTP * gRPC **Example request:** ``` curl -X PUT https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/apm-slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "id": "", "apmSlo": { "name": "Checkout Service Error Rate", "targetThresholdPercentage": 99.9, "window": { "sloTimeFrame": "SLO_TIME_FRAME_14_DAYS" }, "apmSli": { "services": ["checkout-service"], "filters": [{ "key": "environment", "values": ["production"] }], "groupingKeys": ["environment", "region"], "sliType": { "errorConfig": {} } } }, "metricSource": "APM_SOURCE_SPAN_METRICS" }' ``` **Example response:** ``` { "slo": { "slo": { "id": "", "name": "Checkout Service Error Rate", "targetThresholdPercentage": 99.9, "productType": "SLO_PRODUCT_TYPE_APM" } }, "effectedSloAlertIds": [""] } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.ApmSloService/ReplaceApmSlo <", "apm_slo": { "name": "Checkout Service Error Rate", "target_threshold_percentage": 99.9, "window": { "slo_time_frame": "SLO_TIME_FRAME_14_DAYS" }, "apm_sli": { "services": ["checkout-service"], "filters": [{ "key": "environment", "values": ["production"] }], "grouping_keys": ["environment", "region"], "sli_type": { "error_config": {} } } }, "metric_source": "APM_SOURCE_SPAN_METRICS" } EOF ``` **Example response**: ``` { "slo": { "slo": { "id": "", "name": "Checkout Service Error Rate", "target_threshold_percentage": 99.9, "product_type": "SLO_PRODUCT_TYPE_APM" } }, "effected_slo_alert_ids": [""] } ``` ### Edit custom SLO[​](#edit-custom-slo "Direct link to Edit custom SLO") * HTTP * gRPC **Example request:** ``` curl -X PUT https://api.eu2.coralogix.com/mgmt/openapi/4/v1/slo/slos \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "id": "", "name": "Service Call Success Rate", "description": "Tracks the success rate of service calls by measuring non-error responses across all services and Kubernetes nodes", "creator": "sre-team@example.com", "labels": { "sampleLabel": "Kubernetes" }, "revision": { "revision": 1, "updateTime": "1970-01-01T00:08:06.000000435Z" }, "grouping": { "labels": [ "k8s_node_name", "service_name" ] }, "targetThresholdPercentage": 99, "sloTimeFrame": "SLO_TIME_FRAME_21_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(calls_total_total{status_code!='STATUS_CODE_ERROR'}) by (service_name, k8s_node_name)" }, "totalEvents": { "query": "sum(calls_total_total) by (service_name, k8s_node_name)" } } } ``` **Example response:** ``` { "slo": { "id": "", "name": "Service Call Success Rate", "description": "Tracks the success rate of service calls by measuring non-error responses across all services and Kubernetes nodes", "creator": "sre-team@example.com", "labels": { "sampleLabel": "Kubernetes" }, "revision": { "revision": 1, "updateTime": "2025-08-06T20:37:50.431Z" }, "grouping": { "labels": [ "k8s_node_name", "service_name" ] }, "createTime": "2025-08-06T20:37:50.431Z", "updateTime": "2025-08-06T20:50:42.757Z", "targetThresholdPercentage": 99, "sloTimeFrame": "SLO_TIME_FRAME_21_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "sum(calls_total_total{status_code!=\'STATUS_CODE_ERROR\'}) by (service_name, k8s_node_name)" }, "totalEvents": { "query": "sum(calls_total_total) by (service_name, k8s_node_name)" } } }, "effectedSloAlertIds": [ "" ] } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.slo.v1.SlosService/ReplaceSlo <", "name": "Uptime SLO", "description": "Uptime SLO description", "creator": "Corporation Inc.", "labels": { "sample_label": "Payments service" }, "revision": { "revision": 327, "updateTime": "1970-01-01T00:08:06.000000435Z" }, "grouping": { "labels": [ "grouping_label_1", "grouping_label_2" ] }, "targetThresholdPercentage": 749.21533, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "" }, "totalEvents": { "query": "" } } } EOF ``` **Example response:** ``` { "slo": { "id": "", "name": "Uptime SLO", "description": "Uptime SLO description", "creator": "Corporation Inc.", "labels": { "sample_label": "Payments service" }, "revision": { "revision": 327, "updateTime": "1970-01-01T00:08:06.000000435Z" }, "grouping": { "labels": [ "grouping_label_1", "grouping_label_2" ] }, "targetThresholdPercentage": 749.21533, "sloTimeFrame": "SLO_TIME_FRAME_28_DAYS", "requestBasedMetricSli": { "goodEvents": { "query": "" }, "totalEvents": { "query": "" } } }, "affected_slo_alert_ids": [""] } ``` ## Using the SLO API with Alerts[​](#using-the-slo-api-with-alerts "Direct link to Using the SLO API with Alerts") ### Create SLO alert[​](#create-slo-alert "Direct link to Create SLO alert") Note An SLO ID is required to create an SLO alert. * HTTP * gRPC **Example request**: ``` curl -X POST https://api.eu2.coralogix.com/mgmt/openapi/3/alerts/alerts-general/v3/alert-defs \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "name": "SLO Alert", "description": "", "enabled": true, "priority": "ALERT_DEF_PRIORITY_P1", "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "sloThreshold": { "sloDefinition": { "sloId": "" }, "errorBudget": { "rules": [ { "condition": { "threshold": 100 }, "override": { "priority": "ALERT_DEF_PRIORITY_P1" } } ] } }, "groupByKeys": ["service_name", "status_code"], "incidentsSettings": { "minutes": 10, "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" }, "notificationGroup": { "groupByKeys": [], "webhooks": [], "destinations": [], "router": { "id": "router_default", "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" } }, "notificationGroupExcess": [], "entityLabels": {}, "phantomMode": false, "deleted": false }' ``` **Example response**: ``` { "alertDef": { "alertDefProperties": { "name": "SLO Alert", "description": "", "enabled": true, "priority": "ALERT_DEF_PRIORITY_P1", "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "sloThreshold": { "sloDefinition": { "sloId": "" }, "errorBudget": { "rules": [ { "condition": { "threshold": 100 }, "override": { "priority": "ALERT_DEF_PRIORITY_P1" } } ] } }, "groupByKeys": [ "service_name", "status_code" ], "incidentsSettings": { "minutes": 10, "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" }, "notificationGroup": { "groupByKeys": [], "webhooks": [], "destinations": [], "router": { "id": "router_default", "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" } }, "notificationGroupExcess": [], "entityLabels": {}, "phantomMode": false, "deleted": false }, "id": "", "alertVersionId": "", "createdTime": "2025-08-12T10:09:30Z", "updatedTime": "2025-08-12T10:09:30Z", "lastTriggeredTime": null } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.alerts.v3.AlertDefsService/CreateAlertDef <" }, "errorBudget": { "rules": [ { "condition": { "threshold": 1 }, "override": { "priority": "ALERT_DEF_PRIORITY_P3" } }, { "condition": { "threshold": 2 }, "override": { "priority": "ALERT_DEF_PRIORITY_P2" } } ] } } } } EOF ``` **Example response**: ``` { "alertDef": { "alertDefProperties": { "name": "SLO Alert", "enabled": true, "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "incidentsSettings": { "notifyOn": "NOTIFY_ON_TRIGGERED_AND_RESOLVED", "minutes": 5 }, "notificationGroup": {}, "phantomMode": false, "deleted": false, "sloThreshold": { "sloDefinition": { "sloId": "" }, "errorBudget": { "rules": [ { "condition": { "threshold": 1 }, "override": { "priority": "ALERT_DEF_PRIORITY_P3" } }, { "condition": { "threshold": 2 }, "override": { "priority": "ALERT_DEF_PRIORITY_P2" } } ] } } }, "id": "", "createdTime": "2025-08-12T09:31:36Z", "updatedTime": "2025-08-12T09:31:36Z", "alertVersionId": "" } } ``` ### List SLO alerts[​](#list-slo-alerts "Direct link to List SLO alerts") Before editing or deleting an SLO using the [Edit](#edit-slo) or [Delete](#delete-slo) API methods, we recommend first using the List alerts method to review any related SLO alerts that could be impacted by the SLO update. * HTTP * gRPC **Example request**: ``` curl -X GET "https://api.eu2.coralogix.com/mgmt/openapi/3/alerts/alerts-general/v3/alert-defs?queryFilter.typeSpecificFilter.sloFilter.sloId=" \ -H "Authorization: Bearer " ``` **Example response:** ``` { "alertDefs": [ { "alertDefProperties": { "name": "Service Call Success Rate Alert", "description": "", "enabled": true, "priority": "ALERT_DEF_PRIORITY_P1", "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "sloThreshold": { "sloDefinition": { "sloId": "" }, "errorBudget": { "rules": [ { "condition": { "threshold": 100 }, "override": { "priority": "ALERT_DEF_PRIORITY_P1" } } ] } }, "groupByKeys": [ "k8s_node_name", "service_name" ], "incidentsSettings": { "minutes": 10, "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" }, "notificationGroup": { "groupByKeys": [], "webhooks": [], "destinations": [], "router": { "id": "router_default", "notifyOn": "NOTIFY_ON_TRIGGERED_ONLY_UNSPECIFIED" } }, "notificationGroupExcess": [], "entityLabels": {}, "phantomMode": false, "deleted": false }, "id": "a818b5a6-37ca-4df2-8465-32954c247540", "alertVersionId": "5e58a0dc-2a7b-49f7-a187-b342911f4d26", "createdTime": "2025-08-06T20:39:49Z", "updatedTime": "2025-08-06T20:50:43Z", "lastTriggeredTime": "2025-08-06T21:00:11Z" } ], "pagination": { "totalSize": 1, "nextPageToken": null } } ``` **Example request**: ``` grpcurl -H "Authorization: Bearer " -d @ api.eu2.coralogix.com:443 com.coralogixapis.alerts.v3.AlertDefsService/ListAlertDefs <" } ] } } } } EOF ``` **Example response**: ``` { "alert_defs": [ { "alert_def_properties": { "group_by_keys": [], "notification_group_excess": [], "entity_labels": {}, "name": { "value": "Test-10.8" }, "description": null, "enabled": { "value": true }, "priority": "ALERT_DEF_PRIORITY_P5_OR_UNSPECIFIED", "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "incidents_settings": { "notify_on": "NOTIFY_ON_TRIGGERED_AND_RESOLVED", "minutes": { "value": 5 } }, "notification_group": { "group_by_keys": [], "webhooks": [], "destinations": [] }, "phantom_mode": { "value": false }, "deleted": { "value": false }, "slo_threshold": { "slo_definition": { "slo_id": { "value": "" } }, "error_budget": { "rules": [ { "condition": { "threshold": { "value": 1 } }, "override": { "priority": "ALERT_DEF_PRIORITY_P3" } }, { "condition": { "threshold": { "value": 2 } }, "override": { "priority": "ALERT_DEF_PRIORITY_P2" } } ] } } }, "id": { "value": "" }, "created_time": { "seconds": "1754831041", "nanos": 0 }, "updated_time": { "seconds": "1754831041", "nanos": 0 }, "last_triggered_time": null, "alert_version_id": { "value": "25bfb68c-ab5f-42a1-9384-f9f0bdad64a0" } }, { "alert_def_properties": { "group_by_keys": [], "notification_group_excess": [], "entity_labels": {}, "name": { "value": "Alert Test" }, "description": null, "enabled": { "value": true }, "priority": "ALERT_DEF_PRIORITY_P5_OR_UNSPECIFIED", "type": "ALERT_DEF_TYPE_SLO_THRESHOLD", "incidents_settings": { "notify_on": "NOTIFY_ON_TRIGGERED_AND_RESOLVED", "minutes": { "value": 5 } }, "notification_group": { "group_by_keys": [], "webhooks": [], "destinations": [] }, "phantom_mode": { "value": false }, "deleted": { "value": false }, "slo_threshold": { "slo_definition": { "slo_id": { "value": "" } }, "error_budget": { "rules": [ { "condition": { "threshold": { "value": 1 } }, "override": { "priority": "ALERT_DEF_PRIORITY_P3" } }, { "condition": { "threshold": { "value": 2 } }, "override": { "priority": "ALERT_DEF_PRIORITY_P2" } } ] } } }, "id": { "value": "" }, "created_time": { "seconds": "1754334866", "nanos": 0 }, "updated_time": { "seconds": "1754334866", "nanos": 0 }, "last_triggered_time": { "seconds": "1754620923", "nanos": 0 }, "alert_version_id": { "value": "" } } ], "pagination": { "total_size": { "value": 2 }, "next_page_token": null } } ``` ## Additional resources[​](#additional-resources "Direct link to Additional resources") | | | | ------------------- | ----------------------------------------------------------------------------------------------- | | Coralogix Endpoints | [Coralogix Endpoints](https://docs-docusaurus.kinsta.page/integrations/coralogix-endpoints/.md) |