> ## 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.

# Tokens de Autenticação

> Ciclo de vida dos tokens de autenticação: geração automática, uso com X-Jelou-Token, gestão com CLI e exemplos práticos.

## O que são runtime tokens?

Runtime tokens (prefixo `jfn_rt_`) são credenciais que autenticam requisições às suas funções em produção.

## Geração automática

O primeiro deploy gera um token automaticamente:

```bash theme={null}
jelou functions deploy
# ✓ Deployed
# ⚠ A default runtime token was created for this function.
#   Save it now — it will not be shown again.
# ▸ Token    jfn_rt_abc123...
```

<Warning>
  O token é exibido **uma única vez**. Se perdê-lo, crie um novo com `jelou tokens create`.
</Warning>

## Como usar

Envie o token no header `X-Jelou-Token`:

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

## Gestão com CLI

```bash theme={null}
jelou tokens list minha-funcao
jelou tokens create minha-funcao --name ci-deploy
```

<Warning>
  Criar um token gera um **redeploy automático** da sua função. O código não muda, mas a plataforma precisa atualizar os tokens disponíveis no ambiente de execução.
</Warning>

```bash theme={null}
jelou tokens revoke minha-funcao <token-id> -y
```

<Warning>
  Revogar um token também gera um **redeploy automático**. Clientes usando esse token começarão a receber `401` assim que o redeploy terminar.
</Warning>

## Múltiplos tokens

Você pode ter vários tokens ativos por função. Revogar um não afeta os outros.

## Perdeu o token?

Crie um novo: `jelou tokens create minha-funcao --name novo`. O anterior continua ativo.