coder/docs/reference/cli/secret/list.md

title, description

title	description
`coder secret list`	List secrets, or show one by name

List secrets, or show one by name

Aliases:

• ls

Usage

coder secret list [flags] [name]

Description

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 "replaced by" column shows user secrets whose env var or file is taken by a workspace secret.

Options

--workspace

Type	string

Include the secrets of this workspace's latest build. Defaults to the current workspace when run inside one.

--build-id

Type	string

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

-c, --column

Type	[created|name|updated|source|env|file|enabled|replaced by|description]
Default	name,source,created,updated,env,file,enabled,replaced by,description

Columns to display in table output.

-o, --output

Type	table|json
Default	table

Output format.