## secrets

Use the `input.secret` function to securely access user-defined secret values by their keys.

### Accessing secrets (automations only)

Your scripting automation action can use secrets that are passed to it using the built-in `input.secret` function. Click 'Add existing secret' within 'Secrets' and specify the secrets to access. Editable secret names will be shown, allowing you to refer to the secret contents.

```js
// How to retrieve a secret
const someSpecificSecret = input.secret('Some Secret Key');
```

### Purpose

The `input` object securely stores sensitive data like API keys and passwords, allowing you to access them in scripts without hardcoding.

### Important Notes

- Referencing secrets in your script will lock editing to only users who can access those secrets.
- Handle secret values with care to maintain security and confidentiality.
- Secrets will be limitedly redacted from console functions like `console.log` to prevent accidental exposure.