# Versões e mudanças

Existe uma versão do contrato, `2026-10-03`. Ela é a padrão e a mais recente.

## Como a versão funciona

- Sem `Kernos-Version`, vale a mais nova.
- Com `Kernos-Version`, a API usa a que você pediu e responde no mesmo cabeçalho qual usou. Versão que não existe recusa com [`version_unknown`](/erros/version_unknown.md).
- Os SDKs fixam a versão do contrato com que foram gerados.

## 2026-10-03

O contrato público inicial.

- 25 rotas públicas, a chave `ksk_` com ações e CDs, o limite por chave e o registro de pedidos.
- 6 eventos públicos por webhook assinado, e `GET /v1/events` para ler os mesmos corpos.
- Acrescentado depois, sem mudar nada do que existia: reenvio de entrega pela API, troca do segredo do webhook com carência (`grace_hours`, assinatura com dois `v1`), corpo da resposta no registro da chave de teste e `GET /v1/requests/{request_id}`.