Tokens de Autenticação

O que são runtime tokens?

Os runtime tokens (prefixo jfn_rt_) são credenciais legacy que autenticam requisições a funções implantadas antes da migração para API keys de plataforma. As funções implantadas hoje não recebem nenhum runtime token — elas usam uma API key de plataforma desde o primeiro deploy.

A criação de novos runtime tokens (jelou functions tokens create) está depreciada e responde 410 Gone. Os deploys também não geram um automaticamente. Se sua função é nova ou você perdeu seu runtime token, use uma API key de plataforma.

Como usá-los

Se sua função já tinha um runtime token ativo antes da migração, ele continua funcionando: envie-o no header X-Jelou-Token:

curl
Node.js
Python

curl -X POST https://minha-funcao.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "X-Jelou-Token: jfn_rt_abc123..." \
  -d '{"telefone": "5511987654321"}'

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

import requests, os

res = requests.post(
    "https://minha-funcao.fn.jelou.ai",
    headers={
        "Content-Type": "application/json",
        "X-Jelou-Token": os.environ["JELOU_FUNCTION_TOKEN"],
    },
    json={"telefone": "5511987654321"},
)

Regra	Detalhe
Header	`X-Jelou-Token` (runtime tokens legacy não são validados via `Authorization: Bearer`)
Formato	Sem query param, sem body — apenas header
Tamanho máximo	4 KB
Sem token	`401 { "error": "Unauthorized" }`

Gestão com CLI

Listar tokens

jelou functions tokens list minha-funcao
# ▸ 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

Criar token adicional (depreciado)

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>…”. Não é mais possível criar runtime tokens novos, nem mesmo adicionais para um token existente.

jelou functions tokens create minha-funcao --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 credenciais novas, use uma API key de plataforma — veja a alternativa recomendada abaixo.

Revogar token

Revogar tokens existentes (criados antes da depreciação) continua funcionando:

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

Revogar um token também gera um redeploy automático. Clientes que usem esse token começarão a receber 401 assim que o redeploy terminar.

Múltiplos tokens

Se sua função já tem vários tokens ativos de antes da depreciação (um por ambiente, serviço ou equipe), você pode continuar listando-os e revogando-os individualmente. Revogar um não afeta os outros.

Perdeu o token?

Já não é possível gerar um substituto pelo CLI. Em vez disso:

Crie uma API key em apps.jelou.ai
Envie-a como Authorization: Bearer <key> — veja a alternativa recomendada
Se o runtime token anterior foi comprometido, revogue-o: jelou functions tokens revoke minha-funcao <id>

Alternativa recomendada: API keys

O mecanismo suportado para autenticar funções novas (todo novo deploy usa isso desde o início) ou para substituir um runtime token perdido é uma API key de plataforma, não um runtime token:

curl -X POST https://minha-funcao.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"telefone": "5511987654321"}'

Consulte a guia de autenticação para o fluxo completo.

CI/CD

Em pipelines, use uma API key de plataforma em vez de criar runtime tokens:

# A API key é criada uma única vez em apps.jelou.ai e salva como secret de CI
curl -X POST https://minha-funcao.fn.jelou.ai \
  -H "Authorization: Bearer ${{ secrets.FUNCTION_API_KEY }}" \
  -H "Content-Type: application/json" \
  -d '{"telefone": "5511987654321"}'

Brain Studio

Configure sua função como servidor MCP externo usando sua API key:

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

Se sua função é legacy e ainda usa um runtime token, use X-Jelou-Token / jfn_rt_abc123... em vez disso. Consulte a guia do Brain Studio para o fluxo completo.

​O que são runtime tokens?

​Como usá-los

​Gestão com CLI

​Listar tokens

​Criar token adicional (depreciado)

​Revogar token

​Múltiplos tokens

​Perdeu o token?

​Alternativa recomendada: API keys

​CI/CD

​Brain Studio

O que são runtime tokens?

Como usá-los

Gestão com CLI

Listar tokens

Criar token adicional (depreciado)

Revogar token

Múltiplos tokens

Perdeu o token?

Alternativa recomendada: API keys

CI/CD

Brain Studio