> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark metric variant list

> List a metric’s variants

Every configuration of this metric your organization can use: Roark’s own variants and any your organization has added or forked. `isDefault` marks the one the metric is scored with when nothing pins another; pass any variant’s `id` as `sourceVariantId` to pin it on a derived metric. Auto-managed variants (the ones a package materializes for you) are not listed: they are engine state, not configuration you author.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark metric variant list <id-or-slug> [options]
```

> [!NOTE]
>
> Calls `GET /v1/metric/definitions/{idOrSlug}/variants`

## Arguments

**id-or-slug** `string` *required*

Metric definition UUID or its stable slug.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark metric variant list <id-or-slug>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.