---
title: "Delete a metric definition"
method: DELETE
path: "/v1/metric/definitions/{idOrSlug}"
tags: ["Metric"]
---

# Delete a metric definition

`DELETE /v1/metric/definitions/{idOrSlug}`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/metric/definitions/{idOrSlug}`
- Auth: HTTP bearer

Archives (soft-deletes) a custom metric definition, addressed by its UUID or its stable `slug`. The metric is hidden from all reads and stops being collected, but its record and previously collected values are retained. System metrics cannot be deleted. Fails with 409 if the metric is still used as a source by a derived metric (delete those first).

## Path parameters

- `idOrSlug` string, required

## Response `200`

The metric definition was archived

- object
  - `data` object, required: Result of archiving (soft-deleting) a metric definition
    - `id` string, uuid, required: Roark ID of the archived metric definition
    - `deleted` true, required: Always true when the metric definition was successfully archived

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-09-03** `e23709e30785`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/metric/definitions/:idOrSlug/delete.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)