> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Secret Set

> Configurar un secret para los workers

Crea o actualiza un secret encriptado que estara disponible para todos los workers del workspace via `plz.env`.

## Uso

```bash theme={null}
plazbot workers secret set <key> <value>
```

## Argumentos

| Argumento | Descripcion                                      |
| --------- | ------------------------------------------------ |
| `<key>`   | Nombre del secret en formato `UPPER_SNAKE_CASE`. |
| `<value>` | Valor del secret (se almacena encriptado).       |

## Ejemplo

```bash theme={null}
# Configurar API key de Stripe
plazbot workers secret set STRIPE_API_KEY sk_live_abc123

# Configurar webhook URL de Slack
plazbot workers secret set SLACK_WEBHOOK_URL https://hooks.slack.com/services/xxx

# Configurar token de servicio externo
plazbot workers secret set INVENTORY_API_KEY my-secret-token
```

## Formato del key

El key debe cumplir con el formato `UPPER_SNAKE_CASE`:

* Solo letras mayusculas, numeros y guiones bajos.
* Debe iniciar con una letra mayuscula.
* Ejemplos validos: `STRIPE_API_KEY`, `SLACK_WEBHOOK`, `ERP_TOKEN`, `MP_ACCESS_TOKEN`.
* Ejemplos invalidos: `stripe_api_key`, `my-secret`, `123KEY`.

## Acceso desde workers

Los secrets se acceden dentro de un worker usando `plz.env`:

```typescript theme={null}
async run(payload, plz) {
  const apiKey = plz.env.STRIPE_API_KEY
  const webhookUrl = plz.env.SLACK_WEBHOOK_URL

  const res = await fetch(url, {
    headers: { 'Authorization': `Bearer ${apiKey}` }
  })
}
```

## Seguridad

* Los valores se encriptan con AES-256 antes de almacenarse.
* Nunca se exponen en texto plano en la interfaz ni en los logs.
* Se desencriptan solo en runtime dentro del Edge Function.
* Cada workspace tiene sus propios secrets aislados.

<Tip>
  Puedes ver la lista de secrets configurados (sin sus valores) con `plazbot workers secret list` o desde el tab "Secrets" en el dashboard.
</Tip>