---
title: "Update Metric Group"
method: PATCH
path: "/metric-groups/{metricGroupId}"
---

# Update Metric Group

`PATCH /metric-groups/{metricGroupId}`

## Request

- Base URL: `https://api2.scorecard.io/api/v2`
- URL: `https://api2.scorecard.io/api/v2/metric-groups/{metricGroupId}`
- Auth: HTTP bearer

Update a Metric Group's name, description, or member Metrics. The `metricIds` array replaces the group's current set of Metrics.

## Path parameters

- `metricGroupId` string, required

## Request body

- object
  - `name` string: The new name of the Metric Group.
  - `description` string: The new description of the Metric Group.
  - `metricIds` string[]: The new set of Metric IDs for the group, replacing the current set. Every Metric must belong to the same Project as the group.

## Response `200`

Metric Group updated successfully.

- MetricGroup: A Metric Group is a named collection of Metrics within a Project, used to score or compare records with a consistent set of Metrics.
  - `id` string, required: The ID of the Metric Group.
  - `projectId` string, required: The ID of the Project the Metric Group belongs to.
  - `name` string, required: The name of the Metric Group.
  - `description` string, required: The description of the Metric Group.
  - `metricIds` string[], required: The IDs of the Metrics in the group.
  - `createdAt` string, required: The ISO 8601 timestamp when the Metric Group was created.
  - `updatedAt` string, required: The ISO 8601 timestamp when the Metric Group was last updated.

## Other responses

- `401`: Error indicating that the request is not authenticated.
- `500`: An internal service error indicating an issue with the Scorecard service.

## Changes

- **2026-09-22** `aea3bbdea11d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/metric-groups/:metricGroupId/patch.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) - [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scorecard-ai/apis/scorecard-api/revisions/b40e47e06b7f?raw)