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

# Flavors

> List available compute flavors (instance types).

Flavors define the hardware configuration available for compute instances — including CPU, memory, and GPU specifications.

## Subcommands

* [list](#list) — List flavors

***

## list

List the flavors in a region, including pinned-only ones. If you omit `--region`, the CLI opens an interactive picker, so always pass it in scripts.

The table shows each flavor's ID, name, architecture, CPU count, memory, disk, whether it is pinned-only, and its GPUs.

```bash theme={null}
nscale flavors list --region <region-id> [flags]
```

### Flags

<table>
  <thead><tr><th>Flag</th><th>Description</th></tr></thead>

  <tbody>
    <tr><td><code>{"--org string"}</code></td><td>Organization ID</td></tr>
    <tr><td><code>{"--region string"}</code></td><td>Region ID</td></tr>

    <tr>
      <td>
        <code>
          {"--json"}
        </code>
      </td>

      <td>Emit the full JSON payload (mutually exclusive with <code>-q</code>)</td>
    </tr>

    <tr>
      <td>
        <code>
          {"-q, --query stringArray"}
        </code>
      </td>

      <td>jq filter for value extraction (see <a href="/docs/cli/query-output">Query output with <code>-q</code></a>)</td>
    </tr>
  </tbody>
</table>

### Pinned-only flavors

A pinned-only flavor is reservation-only: a server using it must target a specific host, so instances and on-demand node pools can't use it. These flavors show `yes` in the **Pinned** column and have `spec.pinnedOnly` set to `true` in JSON output. The interactive flavor pickers for [instances](/docs/cli/instances#create) and [compute node pools](/docs/cli/kubernetes#nodepool-create) leave them out.

To list only the flavors an instance can use:

```bash theme={null}
nscale flavors list --region <region-id> \
  -q '.[] | select(.spec.pinnedOnly != true) | .metadata.id'
```

### Examples

```bash theme={null}
# List all flavors in a region
nscale flavors list --org <org-id> --region <region-id>

# Output as JSON
nscale flavors list --org <org-id> --region <region-id> --json
```


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