---
title: "Bulk Update Custom Metrics"
method: PUT
path: "/v1/update-metrics"
tags: ["Custom Metrics"]
---

# Bulk Update Custom Metrics

`PUT /v1/update-metrics`

Bulk update custom metrics: apply the same patch to each metric in metric_ids.
Only keys present in updates are applied; each key's value (including null) is written.

## Headers

- `X-API-Key` string, required

## Request body

- BulkUpdateMetricsRequest — Request for bulk updating custom metrics (same patch applied to each metric).
  - `metric_ids` string[], required — UUIDs of custom metrics to update
  - `updates` MetricUpdates, required — Patch payload; only keys that are present are applied; each value (including null) is written.
    - `tags` string[], nullable
    - `agent_ids` integer[], nullable
    - `eval_modality` 'AUDIO' | 'TEXT' | 'AUTO' — Enum representing the evaluation route of a call.
    - `eval_segment` 'agent' | 'user' | 'all', nullable
    - `scope` 'observability' | 'simulations' | 'all', nullable
    - `model` string, nullable
    - `audio_model` string, nullable
    - `temperature` number, nullable
    - `allow_not_applicable` boolean, nullable

## Response `200`

Successful Response

- BulkUpdateMetricsResponse — Response for bulk update (success, message, updated count).
  - `success` boolean — Whether the operation succeeded
  - `message` string, nullable — Human-readable summary; frontend falls back to 'Updated N custom metric(s)' if missing
  - `updated` integer, nullable — Number of metrics updated

## 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/f48cef80963f/schema)