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

# nsc artifact list

List artifacts in your workspace.

`artifact list` finds stored [artifacts](https://namespace.so/docs/architecture/storage/artifact-storage.md).
Filter the results by artifact namespace, labels, or a regular expression
matching the artifact path.

## Usage

```bash theme={null}
nsc artifact list [flags]
```

### Example

List artifacts whose paths begin with `build-outputs/`:

```bash theme={null}
nsc artifact list --match_path_regex '^build-outputs/' --output json
```

## Options

### --include\_expired

Include expired entries in the results.

### --labels \<key=value>

Only return artifacts with these labels. Accepts a `stringToString` map of
key-value pairs, such as `--labels project=app,branch=main`. Defaults to an
empty map (`[]`).

### --match\_path\_regex string

Only return artifacts whose path matches this regular expression.

### --max\_entries int32

Maximum number of artifacts to return, up to `10000`. Defaults to `50`.

### --namespaces strings

Only return artifacts belonging to any of the specified namespaces.

### --output, -o \<format>

Output format. One of `plain` or `json`. Defaults to `plain`.

## Related Topics

* [nsc artifact describe](https://namespace.so/docs/reference/cli/artifact-describe.md) - Inspect an artifact's metadata
* [nsc artifact download](https://namespace.so/docs/reference/cli/artifact-download.md) - Download an artifact
* [nsc artifact upload](https://namespace.so/docs/reference/cli/artifact-upload.md) - Upload an artifact


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