sre-helmcode · Oct 11, 2026 · Oct 11, 2026 · Oct 11, 2026 · Oct 11, 2026 · Oct 11, 2026
diff --git a/src/content/docs-es/apps.md b/src/content/docs-es/apps.md
@@ -1,7 +1,7 @@
 ---
 title: Apps
 description: Despliega tus apps desde GitHub a NaN Cloud en minutos.
-order: 21
+order: 23
 group: Guías
 ---
 

diff --git a/src/content/docs-es/automations.mdx b/src/content/docs-es/automations.mdx
diff --git a/src/content/docs-es/examples.md b/src/content/docs-es/examples.md
@@ -1,7 +1,7 @@
 ---
 title: Ejemplos
 description: Fragmentos de código para conectarte a la API de NaN con Python, Node.js, curl y más.
-order: 20
+order: 22
 group: Guías
 ---
 

diff --git a/src/content/docs-es/intro.md b/src/content/docs-es/intro.md
@@ -32,5 +32,7 @@ Los límites van por API key — un tope de peticiones por minuto y un máximo d
 - [Modelos](/es/docs/models): las fichas técnicas y los límites.
 - [Workspaces](/es/docs/workspaces): tu propia máquina en la nube, por SSH y en el navegador, con agentes de código listos para usar.
 - [Runs de agentes](/es/docs/runs): dale una tarea a un agente dentro de tu workspace y deja que trabaje solo.
+- [Automatizaciones](/es/docs/automations): guarda una tarea de agente y lánzala desde un webhook, una programación o tus scripts, con las aprobaciones que elijas.
+- [Webhooks y programaciones](/es/docs/webhooks): conecta GitHub, Stripe o tus propios sistemas, o ejecútala con una programación.
 - [Ejemplos](/es/docs/examples): fragmentos en Python, Node.js y curl.
 - Soporte: reporta incidencias en `#support` de Discord.
diff --git a/src/content/docs-es/nan-cli.mdx b/src/content/docs-es/nan-cli.mdx
@@ -168,6 +168,21 @@ nan runs logs <id> -f
 
 El run se ejecuta en el workspace, no en tu máquina, así que sigue aunque cierres la terminal. Los comandos de runs usan tu sesión de `nan auth login`, o un token de plataforma desde `NAN_TOKEN`, `--token-file` o `nan auth login --api-token` para scripts, CI y servidores. Todos los flags, el orden de autenticación, los códigos de salida y la API están en [Runs de agentes](/es/docs/runs).
 
+## Automatizaciones
+
+Desde la v0.1.26 la CLI también lista y lanza tus [automatizaciones](/es/docs/automations), y te enseña las propuestas que esperan tu aprobación:
+
+```bash
+nan automations ls
+nan automations run "PR review" --input '{"pr": 42}'
+nan approvals ls
+nan runs proposal <run-id>
+nan runs reject <run-id>
+nan secrets ls
+```
+
+Crear o editar automatizaciones y triggers, escribir secretos y aprobar propuestas solo se hace en el portal, con sesión iniciada en tu navegador: si lo intentas, la CLI te dice dónde. Un run que espera aprobación hace que `nan run`, `nan runs logs -f` y `nan automations run` salgan con código 10. Los detalles están en [Automatizaciones](/es/docs/automations#desde-la-terminal).
+
 ## Actualizar
 
 Vuelve a pasar el instalador. Siempre trae la última versión publicada y sobrescribe la que tengas:

diff --git a/src/content/docs-es/runs.mdx b/src/content/docs-es/runs.mdx
@@ -22,6 +22,8 @@ Puedes lanzar un run de tres formas, y las tres ven los mismos runs:
 - Desde tu terminal, con `nan run`.
 - Desde tus propios scripts, con la API.
 
+Para lanzar la misma tarea una y otra vez, desde un webhook, con una programación o con acciones que esperan tu aprobación, guárdala como una [automatización](/es/docs/automations).
+
 ## Antes de empezar
 
 - **Un workspace encendido**, con Pi o Hermes instalado. Puedes instalar cualquiera de los dos desde el panel de **Software** del workspace.
@@ -100,6 +102,7 @@ La carpeta tiene que estar dentro de `/home/nan`, tu carpeta personal en el work
 | `failed` | El agente se ha parado con un error, o el run no ha podido empezar (por ejemplo, **Separate branch** en **On** en una carpeta que no es un repositorio). |
 | `cancelled` | Lo has cancelado tú. |
 | `timed_out` | Ha llegado a su tiempo máximo y se ha parado. |
+| `awaiting_approval` | Solo para runs de [automatizaciones](/es/docs/automations): el agente ha terminado y ha propuesto acciones que esperan tu aprobación. |
 
 El portal muestra los mismos estados en inglés y con mayúscula, por ejemplo **Running**, **Succeeded** o **Cancelled**.
 
@@ -129,6 +132,8 @@ Los runs usan la clave de inferencia del workspace, la misma que usan sus agente
 
 Los secretos del archivo de entorno de tu workspace, como esa clave de inferencia o un token de bot de Telegram, aparecen como `***` en los logs y resultados de los runs, así que un log no los filtra.
 
+Los secretos que guardas en tus ajustes no se les dan a estos runs: solo llegan a los runs de las [automatizaciones](/es/docs/automations#secretos) a las que los asignas.
+
 ## Desde la terminal: `nan run`
 
 La [CLI de NaN](/es/docs/nan-cli) lanza y sigue runs desde tu propia terminal. Necesitas la versión **0.1.25** o posterior: `nan --version` imprime `nan <versión>`.
@@ -211,6 +216,8 @@ nan runs cancel <id>
 | `usage` | Los tokens gastados hasta ahora. |
 | `error` | Algo ha ido mal, con un código. |
 | `finished` | El run ha terminado: su estado y el resumen del agente. |
+| `approval_required` | Un run de una [automatización](/es/docs/automations) ha propuesto acciones que esperan tu aprobación. |
+| `action` | Un paso de la aplicación de las acciones de una automatización. |
 
 ### Códigos de salida
 
@@ -223,6 +230,7 @@ nan runs cancel <id>
 | 2 | se agotó el tiempo máximo |
 | 3 | cancelado |
 | 4 | el workspace no está listo: agente no instalado, sin clave de inferencia o configuración incorrecta |
+| 10 | el run espera tu aprobación (solo runs de [automatizaciones](/es/docs/automations#aprueba-o-rechaza-una-propuesta)) |
 | 64 | error de uso, también tener más de un workspace y no pasar `--ws` |
 | 65 | sin sesión, sesión caducada o sin permiso |
 | 69 | nan.builders no disponible, o se ha perdido el stream (el run sigue, y se imprime el id) |
@@ -253,7 +261,7 @@ nan auth login --api-token < token.txt  # o pásalo por stdin
 
 No pongas nunca un token en la propia línea de comandos: acabaría en el historial de tu shell y en `ps`.
 
-En la CLI, un token de plataforma solo sirve para `nan run` y `nan runs` (consulta [API keys y tokens](#api-keys-y-tokens)). `nan me`, `nan metrics usage` y el panel siguen necesitando una sesión de `nan auth login`.
+En la CLI, un token de plataforma solo sirve para `nan run`, `nan runs`, `nan automations` y `nan approvals` (consulta [API keys y tokens](#api-keys-y-tokens)). `nan me`, `nan metrics usage` y el panel siguen necesitando una sesión de `nan auth login`.
 
 ### Usa la CLI en CI o en un servidor
 
@@ -292,7 +300,7 @@ Hay dos tipos de credenciales que sirven para la API de runs. Las dos están en
 |---|---|---|
 | Formato | `sk-...` | `nan_pat_...` |
 | Inferencia (modelos) | Sí | **No, nunca** |
-| API de la plataforma (runs, tus workspaces) | Sí | Sí |
+| API de la plataforma (runs, automatizaciones, aprobaciones, tus workspaces) | Sí | Sí |
 | Quién puede crearlas | Planes con inferencia | Cualquier miembro con una suscripción activa |
 
 Un **token** es lo que conviene darle a un script que solo gestiona runs. No sirve para llamar a los modelos directamente, pero sí para lanzar runs que gastan tu plan: guárdalo igual de bien que una API key y revócalo si se filtra. Créalo en **Settings → Tokens**:
@@ -301,6 +309,7 @@ Un **token** es lo que conviene darle a un script que solo gestiona runs. No sir
 - Puedes tener hasta **10** tokens activos.
 - Cada uno caduca a los **30, 90 o 365 días**, o nunca.
 - Puedes revocar cualquiera en cualquier momento.
+- Lleva **scopes**, lo que puede hacer: `runs` y `workspaces:read` por defecto. Para listar o lanzar automatizaciones, añade `automations:read` o `automations:run`. Consulta [Tokens para automatizaciones](/es/docs/automations#tokens-para-automatizaciones).
 
 Para crear runs sigue haciendo falta un plan con inferencia, uses la credencial que uses. La [referencia de la API](/es/docs/api#description/platform-tokens) indica qué credencial acepta cada endpoint.