Skip to main content

Delete Metric Config Detail

DELETE 
/metric-configs/:config_name/:config_version

Hard-delete a config. 409 if any run's scoring snapshot still pins it.

Addresses one exact row in workspace_id. There is no soft-delete tier and no restore: once removed, the row is gone and its (name, version) key is free to reuse. Requires admin/editor on the owning workspace. 404 for unknown/already-deleted/foreign.

409 carries usage_count in the response body (via AppError.extra), computed by the same query path the list/detail usage_count field uses — so a caller who read "used in N runs" from a list page sees the identical N here, never a different number.

Request​

Responses​

Successful Response