Skip to main content
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.
Calls PUT /v1/metric/definitions/{idOrSlug}/variants/{variantId}

​
Arguments

​
string
required
Metric definition UUID or its stable slug.
​
string
required
Variant UUID.

​
Options

​
string
Rename the variant. Does not change its configuration, so versionId is unaffected. Default is reserved.
​
string
The rubric this variant applies. LLM judge metrics only.
​
integer
Scale minimum. SCALE output only.
​
integer
Scale maximum. SCALE output only.
​
string
What a true value means. Given to the judge as its polarity rule, so keep it accurate.
​
string
What a false value means. Given to the judge as its polarity rule, so keep it accurate.
​
integer
Maximum classifications returned. CLASSIFICATION output only.
​
string
Free-text audit note recorded on the new version.

​
Example

Every command also takes the global options and sets one of the exit codes.