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

# Secrets de organización

> Administra los secrets a nivel de organización (variables de entorno cifradas) que se inyectan en workflows y funciones en tiempo de ejecución.

`jelou secret` administra los secrets de organización: variables de entorno
cifradas que se inyectan en **workflows y funciones** en tiempo de ejecución.
Por defecto, `list`, `set` y `delete` operan sobre toda la organización; con
`--project` (alias `--brain`) puedes limitar cualquiera de los tres a un solo
proyecto.

| Subcomando             | Descripción                                           |
| ---------------------- | ----------------------------------------------------- |
| `list`                 | Lista los nombres de secret de la organización activa |
| `set <NOMBRE> [valor]` | Crea o actualiza un secret (upsert)                   |
| `delete <NOMBRE>`      | Elimina un secret                                     |

```bash theme={null}
jelou secret list --json
jelou secret set OPENAI_API_KEY                       # interactivo: pide el valor
jelou secret set OPENAI_API_KEY sk-proj-abc123        # inline
echo "$GITHUB_TOKEN" | jelou secret set GITHUB_TOKEN --from-stdin
jelou secret delete OPENAI_API_KEY --yes
jelou secret list --project 01H2XCEJQTG2H5V5NKCYW3J7Z2  # solo los secrets de ese proyecto
```

| Flag                        | Descripción                                                                         |
| --------------------------- | ----------------------------------------------------------------------------------- |
| `--from-stdin`              | Lee el valor desde stdin (ideal para CI)                                            |
| `--yes`, `-y`               | Omite la confirmación al borrar                                                     |
| `--project`, `--brain <id>` | Limita `list`/`set`/`delete` a un proyecto puntual en lugar de toda la organización |

Los nombres deben ser `UPPER_SNAKE_CASE` (ej. `MY_API_KEY`) y son sensibles a
mayúsculas/minúsculas.

<Warning>
  `secret list` devuelve nombres y metadata pero **nunca el valor**. `set` es un
  upsert sin diff: al sobrescribir, el valor anterior se pierde sin recuperación.
  Al borrar un secret, los workflows y funciones que lo leen reciben `undefined`
  en la siguiente ejecución — suele causar degradación silenciosa, no errores.
  Revisa los consumidores conocidos antes de borrar.
</Warning>

<Note>
  Si necesitas secrets por función (no de toda la organización), usa
  `jelou functions secrets set <slug>` — ver la
  [CLI de Functions](/guides/functions/cli).
</Note>
