# metalcloud-cli template-asset list

List template assets with optional filtering

## Synopsis

List all template assets or filter by specific criteria.

Filtering Options:
  --template-id: Filter assets by one or more template IDs
  --usage: Filter assets by usage type (e.g., build_source_image, secondary_image, source_image, etc.)
  --mime-type: Filter assets by file MIME type (e.g., image/png, image/jpeg, application/octet-stream)

Examples:
  ## List all template assets
  metalcloud-cli template-asset list

  ## List assets for specific template
  metalcloud-cli template-asset list --template-id 123

  ## List assets with specific usage
  metalcloud-cli template-asset list --usage build_source_image

  ## List image assets only
  metalcloud-cli template-asset list --mime-type image/png,image/jpeg

  ## Combine multiple filters
  metalcloud-cli template-asset list --template-id 123,456 --usage secondary_image

```
metalcloud-cli template-asset list [flags]
```

### Options

```
  -h, --help                  help for list
      --mime-type strings     Filter assets by file MIME type (e.g., image/png, image/jpeg, etc.).
      --template-id strings   Filter assets by template ID.
      --usage strings         Filter assets by usage type (e.g., logo, icon, etc.).
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli template-asset](/content/configuration/cli/metalcloud-cli_template-asset.md)	 - Manage template assets for OS templates

#### Auto generated by spf13/cobra on 11-Aug-2025