Skip to content
Coder Docs

coder secret list

List secrets, or show one by name

On this page

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 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

Typestring

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

Typestring

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

-c, --column

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

Columns to display in table output.

-o, --output

Typetable|json
Defaulttable

Output format.