---
title: Versões e descontinuação
description: Como a Siglata numera as interfaces para agentes, o que conta como mudança incompatível e quanto aviso você recebe antes de uma remoção.
sidebar:
  order: 9
---

Nada está descontinuado hoje. Esta página diz como a Siglata avisa quando isso mudar.

## Onde está a versão

- **Endpoint MCP:** a versão está na URL, `https://www.siglata.com/v1/mcp`.
- **Servidor MCP:** `serverInfo.version` no `initialize` e o [cartão do servidor](https://www.siglata.com/.well-known/mcp/server-card.json) trazem a versão do servidor, em `MAJOR.MINOR.PATCH`.
- **Busca pública:** a [descrição OpenAPI](https://www.siglata.com/nlweb/openapi.json) traz a versão em `info.version`.

## O que é incompatível

Aumentamos a versão da URL e o `MAJOR` do servidor quando:

- uma operação do MCP muda de nome ou é removida;
- um parâmetro obrigatório é acrescentado, ou um parâmetro ou resultado muda de tipo ou de significado;
- um escopo OAuth deixa de dar o acesso que dava.

Não são incompatíveis: uma operação nova, um parâmetro opcional novo, um campo novo no resultado ou uma mensagem de erro com texto melhor. Ignore campos que você não conhece.

## Aviso antes de remover

1. A mudança é anunciada nesta documentação e a versão antiga continua funcionando ao lado da nova.
2. Cada resposta da versão antiga passa a levar o cabeçalho `Deprecation` ([RFC 9745](https://www.rfc-editor.org/rfc/rfc9745)) e o cabeçalho `Sunset` ([RFC 8594](https://www.rfc-editor.org/rfc/rfc8594)) com a data de remoção.
3. A remoção acontece no mínimo 90 dias depois do anúncio.

## Limites de uso

Quando um limite de taxa recusa uma chamada, a resposta é `429` com o cabeçalho `Retry-After`, em segundos. Hoje isso vale para as rotas de autenticação em `https://www.siglata.com/auth`.