---
title: "Delete a metric"
method: DELETE
path: "/v1/{organization}/metric/{metric_id}/"
tags: ["Metric"]
---

# Delete a metric

`DELETE /v1/{organization}/metric/{metric_id}/`

Delete a metric. The metric is no longer modifiable or manually evaluable, but remains stored, and existing services or simulations that evaluate this metric
will continue to do so. One can still retrieve it using its ID to view its specifics.

#### Permissions
This endpoint requires the following permissions:
* `Metric:DeleteMetric` for the metric to delete.

## Path parameters

- `organization` string, required
- `metric_id` string, required — The ID of the metric to update.

## Headers

- `x-mongo-cluster-name` string, nullable — The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
- `Sec-WebSocket-Protocol` string[]

## Response `200`

Succeeded.

- unknown

## Other responses

- `400` — Metric is used in a simulation unit test.
- `401` — Invalid authorization credentials.
- `403` — Missing required permissions.
- `404` — Specified organization or metric is not found.
- `422` — Invalid request path parameter failed validation.
- `429` — The user has exceeded the rate limit of 100 requests per minute for this endpoint.
- `503` — The service is going through temporary maintenance.

---

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