v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
alarms

Delete a custom metric definition

Stop emitting a custom metric. Takes effect within one flush interval (~10s).

Bins the definition already wrote are kept — they are real observations — and age out with normal metric retention, so the series stays readable and keeps appearing in the catalog for a while with no definition behind it. Alarms pointing at the metric are left alone and will fall to insufficient_data once the series stops.

Needs alarms.manage for an org-wide definition, or projects.alarms.manage on the owning project for a project one.

delete/orgs/{org_id}/metrics/definitions/{definition_id}

Path parameters

org_idstring required
definition_idstring required

Response

Definition deleted

{"stackTrail":"paths:/orgs/{org_id}/metrics/definitions/{definition_id}:delete:responses:204:content:application/json:schema","oasType":"schema","type":"unknown","description":"Successful responses use HTTP 204 and do not include a body."}