# atmos artifacts catalog remove

Unlist a release from the latest published catalog. The artifact, its signatures, and every consumer lock file are untouched.

> ⚠️ Experimental

## Usage

```shell
atmos artifacts catalog remove <ref> --repository=<alias> [flags]
```

## Examples

```shell
# Unlist one release
atmos artifacts catalog remove components/terraform/vpc:1.2.0 --repository=shared
```

## Behavior

Remove only unlists. It deletes no artifact content, no signature, and does not rewrite any lock file, so consumers that pinned the release keep working. When the removed version was the last one of its name, the name is dropped from the catalog. Removal publishes a new catalog revision under the repository's lock when one is available.

## Arguments

- **`ref` (required)** — `name:version` of a listed release. A digest reference cannot be unlisted.

## Flags

- **`--repository`, `-r` (required)** — Configured repository alias. Its `catalog` setting selects the catalog.
  Environment variable: `ATMOS_ARTIFACTS_REPOSITORY`
- **`--format` (optional)** — Output format: `text` (default), `json`, or `yaml`.
  Environment variable: `ATMOS_ARTIFACTS_FORMAT`

## Errors

- **Catalog not configured** — The repository has no `catalog`. Nothing is written.
- **Not listed** — The catalog does not exist or does not list that version.

Every failure exits with a nonzero status.

## Related

- [`atmos artifacts catalog add`](/cli/commands/artifacts/catalog-add)
- [`atmos artifacts delete`](/cli/commands/artifacts/delete)
- [Artifacts Configuration](/cli/configuration/artifacts)