# kosa8 cloud secrets set

Store or replace a secret (the value from a prompt, stdin or --from-env)

## Usage

```
kosa8 cloud secrets set NAME
```

NAME is 1-32 of a-z, 0-9 and -. --upstream is the only place the value is ever
sent (https://host, no path). It goes in the Authorization header as "Bearer …"
unless --header and --scheme say otherwise. A sandbox gets NAME_API_KEY (the
placeholder) and NAME_BASE_URL (the broker's address) unless --env maps others,
e.g. --env OPENAI_API_KEY={{placeholder}} --env OPENAI_BASE_URL={{url}}/v1.

Also known as: `put`, `add`

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--env` | stringArray | a variable the sandbox gets, NAME={{placeholder}} or NAME={{url}}… (repeatable) | `[]` |
| `--from-env` | string | read the value from this variable of the shell |  |
| `--header` | string | the header that carries it (default Authorization) |  |
| `--method` | stringArray | only these HTTP methods (repeatable) | `[]` |
| `--path` | stringArray | only these upstream path prefixes, e.g. /v1/ (repeatable) | `[]` |
| `--pipelines` | bool | let kosa8 Pipelines hand the value to CI jobs |  |
| `--scheme` | string | what goes before the value (default "Bearer " for Authorization) |  |
| `--upstream` | string | https://host the value is sent to (required) |  |

---
Source: https://docs.kosa8.com/reference/cloud-secrets-set/
