---
title: Versões da API
url: https://platform.claude.com/docs/pt-BR/api/versioning
description: "Ao fazer requisições à API, você deve enviar um cabeçalho de requisição `anthropic-version`. Por exemplo, `anthropic-version: 2026-10-21`. Se você estiver usando o [SDK de cliente](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/overview), ele define esse cabeçalho para você."
---

Para qualquer versão específica da API, a Anthropic preserva:

* Parâmetros de entrada existentes
* Parâmetros de saída existentes

No entanto, a Anthropic pode fazer o seguinte:

* Adicionar entradas opcionais adicionais
* Adicionar valores adicionais à saída
* Alterar condições para tipos de erro específicos
* Adicionar novas variantes a valores de saída do tipo enum (por exemplo, tipos de eventos de streaming)

Em geral, se você estiver usando a API conforme documentado nesta referência, a Anthropic não quebrará seu uso.

## Histórico de versões

A Anthropic recomenda usar a versão mais recente da API sempre que possível.

* `2026-10-21`

  * [Migrando para a versão da API 2026-10-21](https://platform.claude.com/docs/pt-BR/api/migration-2026-10-21) mostra como fazer a atualização.

  * Disponível na Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed) e [Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry). No Amazon Bedrock, está disponível para Claude 4.7 e modelos posteriores. Para modelos Claude anteriores no Bedrock, [mantenha a versão da API que você usa hoje](https://platform.claude.com/docs/pt-BR/api/migration-2026-10-21#availability).

  * Messages API:

    * Uma requisição que coloca um bloco `document` diretamente em uma mensagem `assistant` retorna um erro 400.
    * Enviar um bloco `text` com um array `citations` não vazio em uma mensagem `user`, diretamente ou dentro de um bloco `search_result`, retorna um erro 400.
    * Os parâmetros de requisição `temperature`, `top_p` e `top_k` foram removidos. Uma requisição que envie qualquer um deles retorna um erro 400 em todos os modelos.

  * Admin API:

    * Os [grupos RBAC](https://platform.claude.com/docs/pt-BR/api/beta/organization/rbac_groups/list) não retornam mais `roles`. Use `role_ids` em vez disso.
    * Os [membros de grupos RBAC](https://platform.claude.com/docs/pt-BR/api/beta/organization/rbac_groups/members/list), e a resposta à remoção de um deles, não retornam mais `group_id`. Use `rbac_group_id` em vez disso.
    * As [funções RBAC](https://platform.claude.com/docs/pt-BR/api/beta/organization/rbac_roles/list) não retornam mais `name`. Use `display_name` em vez disso.
    * As entradas de “rate limit” (limite de taxa) da [organização](https://platform.claude.com/docs/pt-BR/api/organization/rate_limits/list) e do [workspace](https://platform.claude.com/docs/pt-BR/api/organization/workspaces/rate_limits/list), e a resposta a [definir os limites de taxa de um workspace](https://platform.claude.com/docs/pt-BR/api/organization/workspaces/rate_limits/update), não retornam mais `group_type`. Use `group.type` em vez disso.
    * As [chaves de API](https://platform.claude.com/docs/pt-BR/api/organization/api_keys/list) não retornam mais `workspace_id`. Em vez disso, use `scope.workspace_id`. Ele contém o ID do workspace da chave, incluindo o workspace padrão. Uma chave de todos os workspaces não tem `scope.workspace_id`.

  * Claude Enterprise Analytics API:

    * Os relatórios por usuário de [uso](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics/user_usage_report/list) e de [custo](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics/user_cost_report/list) não têm mais `actor.email`. Use `actor.email_address` em vez disso.
    * A resposta de [resumos de atividade](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics/summaries/list) não tem mais `summaries`. Use `data` em vez disso.

* `2023-06-01`

  * Novo formato para “server-sent events” (eventos enviados pelo servidor), ou SSE, de [streaming](https://platform.claude.com/docs/pt-BR/build-with-claude/streaming):

    * As conclusões são incrementais. Por exemplo, `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `em vez de `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."`.
    * Todos os eventos são [eventos nomeados](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents), em vez de [eventos somente de dados](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages).
    * Removido o evento desnecessário `data: [DONE]`.

  * Removidos os valores legados `exception` e `truncated` nas respostas.

* `2023-01-01`: Lançamento inicial.
