# coder secret

Manage secrets

Aliases:

* secrets

## Usage [#usage]

```console
coder secret
```

## Description [#description]

```console
  - Create a secret:

     $ printf %s "$MYCLI_API_KEY" | coder secret create api-key --description "API key for workspace tools" --env API_KEY --file "~/.api-key"

  - Update a secret:

     $ echo -n "$NEW_SECRET_VALUE" | coder secret update api-key --description "Rotated API key" --env API_KEY --file "~/.api-key"

  - Import secrets from a file:

     $ coder secret import ./secrets.env

  - List your secrets:

     $ coder secret list

  - Show a specific secret:

     $ coder secret list api-key

  - Delete a secret:

     $ coder secret delete api-key
```

## Subcommands [#subcommands]

| Name                                                                   | Purpose                                           |
| ---------------------------------------------------------------------- | ------------------------------------------------- |
| [<code>create</code>](/beta-docs/@main/reference/cli/secret/create/)   | Create a secret                                   |
| [<code>update</code>](/beta-docs/@main/reference/cli/secret/update/)   | Update a secret                                   |
| [<code>import</code>](/beta-docs/@main/reference/cli/secret/import/)   | Import secrets from a file                        |
| [<code>enable</code>](/beta-docs/@main/reference/cli/secret/enable/)   | Enable a secret so it is injected into workspaces |
| [<code>disable</code>](/beta-docs/@main/reference/cli/secret/disable/) | Disable a secret without removing it              |
| [<code>list</code>](/beta-docs/@main/reference/cli/secret/list/)       | List secrets, or show one by name                 |
| [<code>delete</code>](/beta-docs/@main/reference/cli/secret/delete/)   | Delete a secret                                   |