---
title: "GET /api/v1/config/drop-rules"
method: GET
path: "/api/v1/config/drop-rules"
tags: ["DropRule"]
---

# GET /api/v1/config/drop-rules

`GET /api/v1/config/drop-rules`

## Query parameters

- `page.max_size` integer
- `page.token` string
- `slugs` string[]
- `names` string[]

## Response `200`

A successful response.

- Configv1ListDropRulesResponse
  - `drop_rules` Configv1DropRule[]
    - `created_at` string, date-time — Timestamp of when the DropRule was created. Cannot be set by clients.
    - `drop_nan_value` boolean — Drops data points if values are Not a Number (NaN). If set to true, Chronosphere drops NaN data points, along with any published staleness markers. See the [drop rules documentation](https://docs.chronosphere.io/control/shaping/shape-metrics/rules/drop-rules#define-a-value-based-drop-rule) for more information.
    - `filters` Configv1LabelFilter[] — Defines the conditions that determine whether to drop a metric. Drop rules can have multiple filter conditions on different labels, making it possible to drop a subset of the series matching a particular metric name.
      - `name` string — The name of the label to match.
      - `value_glob` string — The glob value of the label to match.
    - `mode` 'ENABLED' | 'DISABLED' | 'PREVIEW'
    - `name` string, required — The name of the DropRule. You can modify this value after the DropRule is created.
    - `slug` string — The unique identifier of the DropRule. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the DropRule is created.
    - `updated_at` string, date-time — Timestamp of when the DropRule was last updated. Cannot be set by clients.
    - `value_based_drop` DropRuleValueBasedDrop
      - `enabled` boolean — Enables dropping metrics based on a set value.
      - `target_drop_value` number, double — The target data point value at which to drop metrics.
  - `page` Configv1PageResult
    - `next_token` string — An opaque page token that identifies the next page of items that the client should request. An empty value indicates that there are no more items to return.

## Other responses

- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/revisions/ee91fd539ced/schema)