Tokens de Autenticación

¿Qué son los runtime tokens?

Los runtime tokens (prefijo jfn_rt_) son credenciales legacy que autentican peticiones a funciones desplegadas antes de la migración a API keys de plataforma. Las funciones desplegadas hoy no reciben ningún runtime token — usan una API key de plataforma desde el primer deploy.

La creación de nuevos runtime tokens (jelou functions tokens create) está deprecada y responde 410 Gone. Los deploys tampoco generan uno automáticamente. Si tu función es nueva o perdiste tu runtime token, usa una API key de plataforma.

Cómo usarlos

Si tu función ya tenía un runtime token activo antes de la migración, sigue funcionando: envíalo en el header X-Jelou-Token:

curl
Node.js
Python

curl -X POST https://mi-funcion.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "X-Jelou-Token: jfn_rt_abc123..." \
  -d '{"telefono": "593987654321"}'

const res = await fetch("https://mi-funcion.fn.jelou.ai", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Jelou-Token": process.env.JELOU_FUNCTION_TOKEN,
  },
  body: JSON.stringify({ telefono: "593987654321" }),
});

import requests, os

res = requests.post(
    "https://mi-funcion.fn.jelou.ai",
    headers={
        "Content-Type": "application/json",
        "X-Jelou-Token": os.environ["JELOU_FUNCTION_TOKEN"],
    },
    json={"telefono": "593987654321"},
)

Regla	Detalle
Header	`X-Jelou-Token` (los runtime tokens legacy no se validan vía `Authorization: Bearer`)
Formato	No query param, no body — solo header
Tamaño máximo	4 KB
Sin token	`401 { "error": "Unauthorized" }`

Gestión con CLI

Listar tokens

jelou functions tokens list mi-funcion
# ▸ Name          Prefix          Last Used              Created
# ▸ default       jfn_rt_abc1..   4/7/2026, 10:30:00 AM  4/1/2026, 2:00:00 PM
# ▸ ci-deploy     jfn_rt_def4..   never                  4/5/2026, 9:00:00 AM

Crear token adicional (deprecado)

jelou functions tokens create responde 410 Gone: “Runtime tokens are deprecated. Create an API key in the apps configuration section (https://apps.jelou.ai) and send it as Authorization: Bearer <key>…”. Ya no es posible crear runtime tokens nuevos, ni siquiera adicionales para un token existente.

jelou functions tokens create mi-funcion --name ci-deploy
# ✗ 410 Runtime tokens are deprecated. Create an API key in the apps
#   configuration section (https://apps.jelou.ai) and send it as
#   `Authorization: Bearer <key>` when invoking the function.

Para credenciales nuevas, usa una API key de plataforma — ver alternativa recomendada más abajo.

Revocar token

Revocar tokens existentes (creados antes de la deprecación) sigue funcionando:

jelou functions tokens revoke mi-funcion <token-id>
# ? Revoke token jfn_rt_def4... for mi-funcion? (y/N) y
# ✓ Token revoked

Revocar un token también genera un redeploy automático. Los clientes que usen ese token empezarán a recibir 401 una vez que el redeploy termine.

Múltiples tokens

Si tu función ya tiene varios tokens activos de antes de la deprecación (uno por entorno, servicio o equipo), puedes seguir listándolos y revocándolos individualmente. Revocar uno no afecta a los demás.

¿Perdiste el token?

Ya no puedes generar un reemplazo con el CLI. En su lugar:

Crea una API key en apps.jelou.ai
Envíala como Authorization: Bearer <key> — ver alternativa recomendada
Si el runtime token anterior fue comprometido, revócalo: jelou functions tokens revoke mi-funcion <id>

Alternativa recomendada: API keys

El mecanismo soportado para autenticar funciones nuevas (todo deploy nuevo usa esto desde el inicio) o para reemplazar un runtime token perdido es una API key de plataforma, no un runtime token:

curl -X POST https://mi-funcion.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"telefono": "593987654321"}'

Consulta la guía de autenticación para el flujo completo.

CI/CD

En pipelines, usa una API key de plataforma en vez de crear runtime tokens:

# La API key se crea una sola vez en apps.jelou.ai y se guarda como secret de CI
curl -X POST https://mi-funcion.fn.jelou.ai \
  -H "Authorization: Bearer ${{ secrets.FUNCTION_API_KEY }}" \
  -H "Content-Type: application/json" \
  -d '{"telefono": "593987654321"}'

Brain Studio

Configura tu función como servidor MCP externo usando tu API key:

Campo	Valor
URL	`https://mi-funcion.fn.jelou.ai/mcp`
Header name	`Authorization`
Header value	`Bearer sk_...`

Si tu función es legacy y todavía usa un runtime token, usa X-Jelou-Token / jfn_rt_abc123... en su lugar. Consulta la guía de Brain Studio para el flujo completo.

​¿Qué son los runtime tokens?

​Cómo usarlos

​Gestión con CLI

​Listar tokens

​Crear token adicional (deprecado)

​Revocar token

​Múltiples tokens

​¿Perdiste el token?

​Alternativa recomendada: API keys

​CI/CD

​Brain Studio

¿Qué son los runtime tokens?

Cómo usarlos

Gestión con CLI

Listar tokens

Crear token adicional (deprecado)

Revocar token

Múltiples tokens

¿Perdiste el token?

Alternativa recomendada: API keys

CI/CD

Brain Studio