Update a metric variant
Rename a variant, change its configuration, or both. Every configuration change creates a new
immutable version and advances versionId; the response carries the advanced value.
Editing one of Roark’s own variants forks it for your organization. The response carries the
new variant’s id, which will differ from the one in the path, and isSystem becomes false. Roark’s
variant is untouched and other organizations keep it. DELETE your fork to go back to it.
Which fields are editable depends on the metric: some Roark metrics lock their prompt or output configuration, and a locked field is rejected rather than ignored.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Metric definition UUID or its stable slug.
Variant UUID.
Body
Change a variant's name, its configuration, or both. Every configuration change creates a new immutable
version and advances versionId.
Editing Roark's own variant forks it for your organization first: the response carries the new variant's id, and other organizations keep the original. Delete that variant to go back to Roark's version.
Rename the variant. Does not change its configuration, so versionId is unaffected. Default is reserved.
1 - 100The rubric this variant applies. LLM judge metrics only.
2000Scale minimum. SCALE output only.
0 <= x <= 100Scale maximum. SCALE output only.
0 <= x <= 100What a true value means. Given to the judge as its polarity rule, so keep it accurate.
200What a false value means. Given to the judge as its polarity rule, so keep it accurate.
200Maximum classifications returned. CLASSIFICATION output only.
x >= 1Free-text audit note recorded on the new version.
500Response
The updated variant, or your organization’s fork of it
One named configuration of a metric.