# coder secret list

List secrets, or show one by name

Aliases:

* ls

## Usage

```console
coder secret list [flags] [name]
```

## Description

```console
Secret values are omitted from the output.

When listing all secrets inside a workspace, or with --workspace or --build-id, the workspace build's secrets are included and the source and "replaced by" columns are shown by default. If a build secret uses the same env var or file as a user secret, the user secret is not delivered on that target and its "replaced by" column names the build secret, for example "env: build/github-token".
```

## Options

### --workspace

| Property | Value               |
| -------- | ------------------- |
| Type     | <code>string</code> |

Include the secrets of this workspace's latest build. Inside a workspace, the default is the build the workspace agent was started from.

### --build-id

| Property | Value               |
| -------- | ------------------- |
| Type     | <code>string</code> |

Include the secrets of this workspace build. Takes precedence over --workspace.

### -c, --column

| Property | Value                                                                                                   |
| -------- | ------------------------------------------------------------------------------------------------------- |
| Type     | <code>\[created\|name\|updated\|source\|env\|file\|enabled\|replaced by\|ephemeral\|description]</code> |
| Default  | <code>name,created,updated,env,file,enabled,description</code>                                          |

Columns to display in table output.

### -o, --output

| Property | Value                    |
| -------- | ------------------------ |
| Type     | <code>table\|json</code> |
| Default  | <code>table</code>       |

Output format.
