Skip to main content

Update Metric Config Detail

PUT 
/metric-configs/:config_name/:config_version

Replace a stored config's payload (metric ref, params, prompts).

Addresses one exact row in workspace_id. Omitted fields are unchanged; params/ prompts set to {} are cleared. Identity and provenance are immutable. Requires admin/editor on the owning workspace. 404 for unknown/deleted/foreign; 422 if the merged document does not validate.

409 once any run has pinned this version: editing in place would retroactively change what a completed run reports it was scored with, so a used config is effectively frozen and the way forward is a new config_version. PUT therefore serves correcting a config before it is used, not revising one after. The refusal is decided by the UPDATE's own predicate, and errs toward refusing — see :func:~aip_api.services.metric_config.update_metric_config and :func:~aip_api.services.metric_config.referencing_runs_clause.

Request​

Responses​

Successful Response