---
title: "Update Metric Settings"
method: PUT
path: "/v1/metric-settings"
tags: ["Custom Metrics"]
---

# Update Metric Settings

`PUT /v1/metric-settings`

Bulk-upsert per-org metric enablement (one row per metric_id).

Only OPTIONAL standard metrics are toggleable (the library add/remove flow);
always-on standards (core/system/red-team) and custom metrics are rejected.

## Headers

- `X-API-Key` string, required

## Request body

- UpdateMetricSettingsRequest
  - `settings` MetricSettingEntry[], required
    - `metric_id` string, uuid, required
    - `is_enabled` boolean, required
    - `override_prompt` string, nullable

## Response `200`

Successful Response

- MetricSettingsResponse
  - `settings` MetricSettingEntry[], required
    - `metric_id` string, uuid, required
    - `is_enabled` boolean, required
    - `override_prompt` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/4ef94eeb836d/schema)