# `smallforce app secret put`

Create or replace a write-only secret

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce app secret put --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce app secret put [options] <name>

Create or replace a write-only secret

Options:
  --value-file <path>             Read the secret from a file, or use - for stdin
  -e, --environment <name-or-id>  Environment name or UUID. Read commands default to preview;
                                  mutations require an explicit environment.
  --app-id <id>                   Application id; defaults to smallforce.json in the current
                                  directory
  --api-key <key>                 SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>             SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                          Print stable machine-readable JSON
  --text                          Print human-readable text
  --format <format>               Output format: text or json
  -h, --help                      display help for command
```

## Related reference

- [`smallforce app secret`](/docs/cli/commands/app/secret): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.