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

# OpenAPI

> Cada função gera automaticamente uma especificação OpenAPI 3.1 acessível em /openapi.json.

## Endpoint automático

Toda função implantada expõe sua spec OpenAPI em:

```
https://<slug>.fn.jelou.ai/openapi.json
```

Este endpoint é **sempre público** — não requer `X-Jelou-Token`.

## Público vs protegido

| Config                     | `security` na spec       |
| -------------------------- | ------------------------ |
| Padrão                     | `[{ "jelouToken": [] }]` |
| `config: { public: true }` | `[]` (sem segurança)     |

## Teste local

```bash theme={null}
jelou functions dev
curl http://localhost:3000/openapi.json | jq .
```

<Tip>
  Anotações `.describe()` do Zod se tornam campos `description` na spec.
</Tip>