---
title: "Save instance level impact metrics configuration"
method: POST
path: "/api/admin/impact-metrics/config"
tags: ["Metrics"]
---

# Save instance level impact metrics configuration

`POST /api/admin/impact-metrics/config`

**Enterprise feature**

Saves a configuration for an instance level impact metric chart without a feature flag

## Request body

- CreateImpactMetricsConfigSchema — Describes the configuration for a single impact metric chart.
  - `id` string — The unique ULID identifier for this impact metric configuration. Generated automatically if not provided.
  - `metricName` string, required — The Prometheus metric series to query. It includes both unleash prefix and metric type and display name
  - `timeRange` 'hour' | 'day' | 'week' | 'month', required — The time range for the metric data.
  - `yAxisMin` 'auto' | 'zero', required — Whether the chart should begin at zero on the y-axis.
  - `aggregationMode` 'rps' | 'count' | 'avg' | 'sum' | 'p95' | 'p99' | 'p50', required — The aggregation mode for the metric data.
  - `labelSelectors` object, required — The selected labels and their values for filtering the metric data.
  - `title` string — Optional title for the impact metric chart.
  - `source` 'internal' | 'external' — The Prometheus data source for this metric. Defaults to internal.

## Response `200`

impactMetricsConfigSchema

- ImpactMetricsConfigSchema — Describes the configuration for a single impact metric chart.
  - `id` string, required — The unique ULID identifier for this impact metric configuration. Generated automatically if not provided.
  - `metricName` string, required — The Prometheus metric series to query. It includes both unleash prefix and metric type and display name
  - `timeRange` 'hour' | 'day' | 'week' | 'month', required — The time range for the metric data.
  - `aggregationMode` 'rps' | 'count' | 'avg' | 'sum' | 'p95' | 'p99' | 'p50', required — The aggregation mode for the metric data.
  - `labelSelectors` object, required — The selected labels and their values for filtering the metric data.
  - `source` 'internal' | 'external' — The Prometheus data source for this metric. Defaults to internal.
  - `displayName` string, required — The human readable display name of the impact metric
  - `yAxisMin` 'auto' | 'zero', required — Whether the chart should begin at zero on the y-axis.
  - `step` '1m' | '15m' | '3h' | '1d', nullable — The step interval for querying metrics data. This is automatically calculated from the timeRange and stored when the metric is created or updated.
  - `title` string — Optional title for the impact metric chart.
  - `mode` 'read' | 'write' — The access mode for this impact metric configuration: "read" when referenced by a safeguard, "write" otherwise.

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/versions/b2c3116e633e/schema)